[Developer] Vernieuwde Moneybird API

Vanaf vandaag is de vernieuwde Moneybird API beschikbaar voor alle gebruikers. Om een goede kwaliteit API te kunnen bieden zijn er enkele wijzigingen doorgevoerd. Daarnaast is het vanaf nu ook mogelijk om offertes en inkomende facturen te benaderen via de API.

Alle informatie is te vinden in de vernieuwde documentatie op onze website.

Endpoints

Omdat we met enige regelmaat onze web applicatie updaten, kan het voorkomen dat de API ook wijzigt. Om te voorkomen dat applicaties die werken met de API vervolgens niet meer werken, is het vanaf nu mogelijk om een versienummer mee te geven aan de URL die je opvraagt. Via een uitgebreide testsuite kunnen wij garanderen dat de API op een bepaalde versie altijd hetzelfde gedrag vertoont. Op deze manier kun je zorgeloos je applicatie bouwen op basis van de Moneybird API.

Kon je vroeger de lijst met facturen opvragen via /invoices.xml, gaat dat nu via /api/v1.0/invoices.xml. Voor nieuwe versies van de API zal het versienummer ophogen. Vanwege de backwardscompability zal het altijd mogelijk blijven om de endpoints zonder versie te benaderen, daarbij krijg je altijd de laatste versie van de API.

Push API

Naast de nieuwe endpoints, bieden we ook een zogenaamde push API. Wanneer je een applicatie koppelt aan de Moneybird API, wil je soms weten wanneer de status van een factuur binnen Moneybird verandert. Via de push API kun je een HTTP POST request op een zelfgekozen URL ontvangen zodra de status van een factuur verandert. Op deze manier kun je eenvoudig acties uitvoeren na een betaling.

Deel dit artikel op je favoriete social netwerk