Met een API token identificeer je je als ontwikkelaar bij Moneybird. Het werkt als een inlogcode voor de API. Er zijn twee soorten tokens:
Persoonlijk token: bedoeld om zelf een koppeling te testen. Je maakt het aan via
Instellingen > Externe en AI-koppelingen. Bij het aanmaken stel je meteen in welke onderdelen het token kan benaderen: facturen, offertes, documenten, bank, uren en/of instellingen. Je kunt ook een read-only token aanmaken. Dit token is alleen beschikbaar als je eigenaar bent van de administratie.Token voor externe applicatie: hierbij ontvang je ook een Client ID. Je maakt het aan via
Gebruikersaccount > Ontwikkelaars. Dit token geeft niet direct toegang tot een administratie; de eigenaar van de administratie moet het eerst autoriseren. Dit token kan ook door iemand anders zijn aangemaakt, bijvoorbeeld de ontwikkelaar van een koppeling.
Als je geen Client ID hebt ontvangen van Moneybird, heb je vermoedelijk het verkeerde soort token aangemaakt. Maak dan een nieuw token aan en kies daarbij voor het token voor een externe applicatie.
Let op: een goed gebouwde koppeling vraagt gebruikers nooit om zelf een API key, token of id te verstrekken. Doet een koppeling dat toch, neem dan contact op met de ontwikkelaar van de koppeling.
Rechten instellen
Bij een persoonlijk token stel je de rechten in op het moment van aanmaken. Na het aanmaken kun je de rechten niet meer wijzigen. Wil je andere rechten? Maak dan een nieuw token aan met de juiste rechten.
Bij authenticatie via OAuth stel je rechten in via scopes. Als je geen scope instelt, is de standaardscope `sales_invoices`. Meer informatie over scopes vind je in de API-documentatie.
Rate limit
De Moneybird API heeft een rate limit van 150 requests per 5 minuten. Dit geldt voor het hele platform en is niet per administratie of ip-adres te verhogen. Doe je veel requests? Stuur ze dan in batches met pauzes ertussen.
Als je veel facturen via de API wilt aanmaken, kun je ook periodieke facturen of abonnementen gebruiken. Met één API-aanroep maakt Moneybird de facturen dan automatisch voor je aan.
Token verwijderen of intrekken
Je kunt een token pas verwijderen nadat je de toegang hebt ingetrokken. Volg deze stappen:
Trek de toegang in via
Instellingen > Externe en AI-koppelingen.Verwijder het token via
Gebruikersaccount > Ontwikkelaars. Rechtsboven verschijnt dan een verwijderknop.
Dit geldt voor zowel persoonlijke tokens als tokens voor externe applicaties.