Integratie

Voor AI-agenten

Deze documentatie is ook platte Markdown. Geef een agent één URL of één bestand en hij kent de hele API.

Drie bestanden

/llms.txt, de index: wat de API is en welke pagina's er zijn, met links naar de Markdown-versie van elke pagina.
/llms-full.txt, alles in één bestand: conventies, fouten en alle endpoints met voorbeelden.
Elke pagina zelf met .md erachter, bijvoorbeeld /documentatie/invoices.md.

Standaard zijn de Markdown-versies Nederlands. Voeg ?lang=en toe voor Engels, bijvoorbeeld /llms-full.txt?lang=en.

Alles ophalen

curl https://docs.cijfr.com/llms-full.txt \
  -o cijfr-api.md

# Engels
curl "https://docs.cijfr.com/llms-full.txt?lang=en" \
  -o cijfr-api-en.md

In je tool

Cursor, Claude Code, Copilot en vergelijkbare tools accepteren documentatie als context of @doc. Geef de URL van llms-full.txt of plak het bestand in je prompt. De OpenAPI-spec op /openapi.json werkt in tools die een spec importeren.

Wat een agent moet weten

Base URL is https://app.cijfr.com, paden beginnen met /api/v1.
Authenticeer met Authorization: Bearer cijfr_live_…, nooit in clientcode.
Bedragen in centen, nooit floats. Btw als vatTreatment of vatRateBps.
Alle POSTs accepteren Idempotency-Key; gebruik hem bij retries.
Antwoorden zijn {data:…} of {error:code}. Rate limit 60 per minuut.
Verstuurde facturen zijn onveranderbaar; correcties zijn creditnota's in de app.