Autentisering och takt

Utan nyckel

200 anrop per dygn och IP-adress. Varken registrering eller header behövs. Första curl-raden ska bara fungera.

Med nyckel

10 000 anrop per månad, gratis under betan. Skicka nyckeln som huvud eller query:

curl -H 'X-API-Key: ka_din_nyckel' 'https://api.kart-api.se/v1/geocode?q=Motala'
curl 'https://api.kart-api.se/v1/geocode?q=Motala&key=ka_din_nyckel'

Nycklar delas ut manuellt under betans första veckor: mejla oss med vad du bygger, så får du en samma dag. Ett självbetjäningsformulär kommer när vi vet att någon vill ha det.

Vad som räknas

Varje anrop till en JSON-yta, till rendering, till routing och till MCP-servern räknas som ett.

Kartrutor, stilar och typsnitt räknas inte. En enda kartvy hämtar dussintals rutor; räknades de vore dygnskvoten slut innan kartan ritats klart en gång. De taktas i stället per sekund, som alla andra anrop: 10 i sekunden med utrymme för skurar.

Läs kvoten ur svaret

Huvud	Betyder
`X-Kartapi-Kvar`	Hur många anrop du har kvar i perioden.
`X-Kartapi-Tak`	Periodens tak (200 per dygn eller 10 000 per månad).
`X-Kartapi-Nyckel`	`nyckellos` eller nyckelns id — så du ser vilken kvot du faktiskt hamnade i.
`X-Kartapi-Kvot: omatt`	Räknaren gick inte att nå. Anropet släpptes igenom, men det är inte räknat.

Den sista raden är med flit synlig. En räknare som inte kan nås får inte stänga API:t för alla, men den får inte heller tiga: annars är "ingen trafik" och "ingen mätning" samma tomma tal i efterhand.

När taket är nått

HTTP/1.1 429 Too Many Requests
Retry-After: 17400
{"detail":"takten nådd","skal":"Utan nyckel gäller 200 anrop per dygn och IP-adress."}

Retry-After är sekunder till periodskiftet. Backa av och försök igen. Slår du i taket regelbundet: hämta en nyckel.

Ogiltig nyckel

En nyckel som inte finns eller är spärrad ger 401 med skäl. Ta bort huvudet, så kör du nyckellöst i stället.