API referentie
De Peil API is een REST API. Alle endpoints vereisen authenticatie via een API-sleutel. Gebruik de API om je gegevens te exporteren, te integreren met andere tools of eigen workflows te automatiseren.
Authenticatie
Alle API-verzoeken moeten een geldige API-sleutel meesturen als Bearer token in de
Authorization-header:
Authorization: Bearer peil_xxxxxxxxxxxxxxxxxxxxxxxx
Verzoeken zonder geldige sleutel retourneren een 401 Unauthorized-respons.
API-sleutels zijn persoonlijk en gekoppeld aan jouw account — deel ze niet.
API-sleutel aanmaken
Je maakt een API-sleutel aan via Instellingen → Developer settings in de Peil-app. Geef je sleutel een herkenbare naam (bijv. "Mijn boekhouder" of "Zapier integratie") zodat je hem later kunt herkennen en intrekken.
Een sleutel wordt slechts eenmalig volledig getoond direct na aanmaken — sla hem daarna op in een wachtwoordmanager of beveiligde omgevingsvariabele.
Base URL
https://api.peil.app/api/v1Voorbeeld
Een verzoek met curl:
curl -H "Authorization: Bearer peil_xxxxxx" \
https://api.peil.app/api/v1/export/clients?format=csv
De format-parameter accepteert csv of json
voor de meeste exportendpoints. Voor archiefexports retourneert het endpoint altijd
een ZIP-bestand.
Exportformaten
De Peil API biedt de volgende exportendpoints. Alle endpoints zijn
GET-verzoeken en vereisen authenticatie.
| Endpoint | Formaat | Inhoud |
|---|---|---|
/export/clients | CSV / JSON | Klantnaam, contactgegevens, aangemaakt |
/export/time-entries | CSV / JSON | Datum, uren, tarief, klant, project |
/export/invoices | CSV / JSON | Factuurnummer, bedrag, status, klant |
/export/invoices/archive | ZIP | Alle PDF-facturen |
/export/full | ZIP | Alle bovenstaande exports gecombineerd |
De volledige interactieve endpoint-referentie staat hieronder. Alle routes, parameters en responsschema's worden automatisch gegenereerd vanuit de live OpenAPI-specificatie.