Een sleutel maken
In de app, onder API-sleutels. Je ziet de sleutel één keer, daarna alleen nog de laatste tekens. Zet hem in elk verzoek in de kopregel Authorization.
Bouwen op boekt.online
Alles wat een hovenier in de app doet kan ook via de API: opdrachtgevers, projecten, uren, diensten, materialen en facturen. Eén sleutel ziet één organisatie.
Eerst proberen
De proefomgeving is dezelfde app met eigen gegevens. Sleutels beginnen daar met gt_test_, er gaat geen mail naar buiten en alles is terug te zetten.
Nooit twee keer
Zet een Idempotency-Key op een POST of PATCH. Komt hetzelfde verzoek binnen 24 uur nog eens binnen, dan krijg je het bewaarde antwoord terug in plaats van een tweede factuur.
Als er iets misgaat
Elke fout komt terug als een probleemdocument met een vaste code. De tekst kan veranderen, de code niet: bouw je koppeling daarop.
Als er iets gebeurt
Acht gebeurtenissen, van customer.created tot invoice.sent. Je kiest per adres waarop je wilt luisteren, en elke aflevering is ondertekend.
Voor een assistent
Zet .md achter het adres van een documentatiepagina en je krijgt dezelfde tekst plat. In llms.txt staat de hele lijst.
Grenzen, zodat niemand de rest platlegt
Ga je eroverheen, dan krijg je code rate_limit_exceeded terug en mag je het een minuut later opnieuw proberen. Wat er per pagina uitkomt bepaal je zelf met per_page.
- Verzoeken per minuut, per sleutel
- 300
- Verzoeken per minuut, per adres
- 600
- Regels per pagina, hoogstens
- 100