# 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`.

```bash
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://api.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 `POST`s 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.