Aan de slag
Authenticatie
Elke aanvraag stuurt een geheime sleutel mee in de Authorization-header.
Sleutel meesturenLink naar deze sectie
Stuur de sleutel mee als Bearer-token in elke aanvraag:
http
Authorization: Bearer pf_live_...Zonder geldige sleutel krijg je 401. Is je onderneming niet op het Team-plan, dan krijg je 403.
Basis-URLLink naar deze sectie
Alle endpoints staan onder https://profactuur.be/api/v1. Verzoeken en antwoorden zijn JSON, behalve PDF- en UBL-downloads.
Eén sleutel, één ondernemingLink naar deze sectie
Elke sleutel hoort bij precies één onderneming en ziet nooit gegevens van een andere onderneming. Een ID van een andere onderneming geeft gewoon 404.
Sleutels beherenLink naar deze sectie
- We bewaren enkel een hash van je sleutel. Kwijt is dus kwijt: maak een nieuwe aan.
- Elk gebruik wordt gelogd met tijd, endpoint en statuscode. Je ziet dit in Instellingen, API.
- Trek een sleutel meteen in als hij gelekt kan zijn. Ingetrokken sleutels werken direct niet meer.