Teller

Betaalde calls kosten credits. Eén credit is vijf eurocent, dezelfde credits als voor kaartexports. Twee sleutels delen één tegoed. Whoami kost niets.

Het tegoed

Geen credits, dan antwoordt de API 402. Dat is geen 429: 429 is te snel, 402 is op. Whoami blijft werken, zodat je kunt zien dat het tegoed op is.

{"fout": "Tegoed op.", "saldo": { "credits": 0, "eenheid_cent": 5, "tegoed_cent": 0 }}

Onder de 200 credits (€10) sturen we één keer het webhook-event saldo.laag, op 0 één keer saldo.op. Niet bij elke call daarna.

Credits koop je onder Billing. De bundel van €50 is 1.000 credits — 55 marktwaarde-calls, of een mix. Auto-opladen (optioneel) stort die bundel bij onder de 200 credits.

Kosten per call

• whoami — 0 credits
• waarde — 18 credits (€0,90)
• invloeden — 16 credits (€0,80)
• adres, woz, label, woningtype — 1 credit (€0,05)

Een call onder de vijf cent kost 1 credit. meta.gefactureerd_cent is het afgeboekte bedrag.

Idempotency-Key

Een herhaalde call met dezelfde Idempotency-Key (max. 24 uur, zelfde sleutel, zelfde voorziening) telt één keer en kost één keer. Eigen id, max. 128 tekens.

Idempotency-Key: 8f3c-jouw-eigen-id

Een key geldt per voorziening. Dezelfde key op adres en waarde zijn twee calls. Zonder header telt elke aanroep.

Een 404 (adres bestaat niet) kost niets. Een geslaagde schatting en een 422 wegens onvoldoende data wel.

Te snel

REST: 60 requests per minuut per sleutel, 30 voor invloeden. MCP: 30 per minuut. Daarboven 429. Dat is de snelheidslimiet, niet het tegoed.