API en webhooks

Naast SSO/SCIM en de boekhoudkoppeling biedt Fiatto API- en webhook-paden. Beheer ze onder Instellingen → Integraties & API (/dashboard/settings/integraties).

Stappen

1. Open Instellingen (accountmenu) → kaart Integraties & API.
2. Maak in de kaart API-sleutels een sleutel aan (Sleutel aanmaken — je ziet hem maar één keer) of voeg een webhook-endpoint toe; bewaar secrets in je vault. Sta je in de sandbox, dan krijgt de sleutel _test_ in de naam en werkt hij alleen op de oefenomgeving.
3. Kies de sleutelsoort zo krap mogelijk: een sleutel uit API-sleutels heeft scope api (de REST-API /api/v1: lezen én schrijven van inkoopaanvragen, facturen, contracten, leveranciers, klanten en verkoop); een sleutel uit BI-connector (Power BI / Excel) heeft scope bi.read en werkt alleen op de read-only OData-feed.
4. Test een event of call; bekijk mislukte bezorgingen in het bezorglog.

Tips

• Draai nooit API-sleutels in een browser of mobiele app.
• Elke sleutel heeft een limiet van standaard 120 verzoeken per minuut; lees de X-RateLimit-*-headers om vóór een 429 af te remmen. Het versiebeleid staat in /api/v1/openapi.json en in de Deprecation-/Sunset-headers: een versie wordt minimaal 12 maanden vooraf afgekondigd.
• Zie ook gegevensexport als je data wilt meenemen zonder API.