De FinBaze API vanuit je code aanroepen
Zet je API-credentials om in echte calls — facturen ophalen, records aanmaken of documenten uploaden vanuit je eigen app of script.
Zet je API-credentials om in echte calls — facturen ophalen, records aanmaken of documenten uploaden vanuit je eigen app of script.
Stappen#
- Installeer
@finbaze/platform-sdkin je project, of bereid een HTTP-client voor als je zonder SDK werkt. - Maak een client met je
clientId,clientSecreten (voor een bedrijf)profileId— of vraag een token aan metPOST https://api.platform.finbaze.com/v2/oauth2/token(grant typeclient_credentials). - Roep resources aan via de SDK (verkoopfacturen, relaties, projecten, bankbetalingen, documentuploads) of stuur GraphQL-requests naar
https://api.platform.finbaze.com/graphqlmet headerAuthorization: Bearer <access_token>. - Gebruik dezelfde queries en mutations als het platform — facturen, relaties, bankdata, documentinbox en meer.
Wat gebeurt er daarna?#
Je integratie kan werk automatiseren tegen live boeken. Roteer of trek credentials in als een secret lekt of een systeem stopt.
Veelgestelde vragen#
Publiceren jullie webhooks?
Ja voor marketplace-apps. Registreer HTTPS-endpoints onder je app in het developerportaal — zie FinBaze app-webhooks ontvangen. API-credentials zonder app pollen nog steeds de API.
Zijn er gepubliceerde rate limits?
Er gelden fair-use-regels in de voorwaarden. Er staat geen vast aantal requests per minuut gepubliceerd.
Kantoorcredentials — welk bedrijf?
Laat het profile-id weg voor kantoor-scoped werk (bijvoorbeeld klanten aanmaken). Geef het profile-id van een gekoppelde klant mee als je in die administratie wilt werken.