Ga naar inhoud
Boekhouden.farshadbashir.nl

API integrations
Inhoudsopgave en zoeken

API-koppelingen

Geef externe software met een persoonlijk token alleen de benodigde rechten en administraties.

Een API-token is een geheime sleutel waarmee externe software namens jouw account kan handelen. Maak voor iedere koppeling een eigen token met zo weinig mogelijk rechten, administraties en geldigheidsduur.

Stap voor stap

  1. 1Open Mijn account, kies API en daarna Nieuw API-token. Bevestig zo nodig je wachtwoord.
  2. 2Geef het token een herkenbare naam en kies een vervaldatum die bij het gebruik past.
  3. 3Selecteer alleen de lees- of schrijfrechten en actieve administraties die de koppeling werkelijk nodig heeft.
  4. 4Maak het token en kopieer de geheime waarde direct naar de koppeling of een wachtwoordmanager. Boekhouden toont de volledige waarde slechts één keer.
  5. 5Controleer regelmatig de vervaldatum en wanneer het token voor het laatst is gebruikt.
  6. 6Trek het token onmiddellijk in als de koppeling stopt of de geheime waarde mogelijk bekend is geworden.

Wat zie je op het scherm?

  • Naam en vervaldatum
  • Rechten
  • Geselecteerde administraties
  • Laatst gebruikt
  • Token intrekken

Wat gebeurt er daarna?

Een verlopen of ingetrokken token werkt direct niet meer. Het token geeft nooit meer toegang dan jouw account op dat moment zelf heeft. Bewaar het niet in een URL, gewone e-mail of openbaar broncodebestand.

Voor ontwikkelaars

  • Stuur het token als Authorization: Bearer <token> en gebruik desgewenst Accept-Language: nl of en.
  • Gebruik voor iedere financiële schrijfopdracht een unieke Idempotency-Key. Stuur bedragen als decimale tekst en geef bij wijzigen of verwijderen de actuele versie mee.
  • De endpoints staan onder /api/v1. Download hieronder het OpenAPI 3.1-contract voor paden, velden en foutstructuren.
OpenAPI 3.1-contract downloaden

Veelvoorkomende situaties

Ik krijg een foutmeldingLees de melding bij het veld, pas je invoer aan en probeer het opnieuw. Andere ingevulde gegevens blijven waar mogelijk staan.
Ik kom niet verderControleer of je alle verplichte velden hebt ingevuld. Werkt een link niet meer? Vraag dan een nieuwe aan.