Feilkoder

Alle feil har samme form: HTTP-status, en stabil kode du kan programmere mot, en melding på norsk for mennesker, eventuelt felt, og request_id du kan oppgi til support.

eksempel

{
  "feil": {
    "kode": "for_mange_kall",
    "melding": "Du har nådd 50 kall per sekund. Vent 1 sekund.",
    "dok": "https://spireapi.com/api/feil/#for_mange_kall",
    "request_id": "req_01JBX9W2K4"
  }
}

Kode	HTTP	Betydning
`ugyldig_parameter`	400	Et felt mangler eller har feil format. «felt» i svaret sier hvilket.
`ugyldig_json`	400	Kroppen kunne ikke leses som JSON.
`uautorisert`	401	Mangler eller ugyldig API-nøkkel.
`ingen_tilgang`	403	Nøkkelen har ikke tilgang til produktet eller operasjonen (f.eks. eID-signering på Start).
`ikke_funnet`	404	Objektet finnes ikke, eller tilhører en annen konto.
`konflikt`	409	Idempotency-Key er brukt med en annen forespørsel, eller objektet er i en tilstand som ikke tillater operasjonen.
`for_stor`	413	Kroppen er over grensen (1 MB JSON, 25 MB dokumenter).
`for_mange_kall`	429	Hastighetsgrensen er nådd. Se Retry-After.
`kvote_brukt`	429	Månedskvoten på Start er brukt opp.
`intern_feil`	500	Feil hos oss. Kallet teller ikke. Prøv igjen og kontakt oss med Spire-Request-Id hvis det vedvarer.
`kilde_utilgjengelig`	503	En ekstern kilde svarer ikke og vi har ikke cache. Prøv igjen om litt.

Hva du bør gjenforsøke

429 og 503: vent så lenge Retry-After sier, og prøv igjen. SDK-ene gjør dette automatisk, opptil fem ganger med eksponentiell ventetid.
500 og nettverksfeil: prøv igjen med samme Idempotency-Key. Kallet er trygt å gjenta.
4xx ellers: ikke gjenforsøk uten å endre forespørselen. Feilen er i kallet, ikke hos oss.

Les mer under feilhåndtering og hastighetsgrenser.

Fant du en feil? Si fra, så retter vi innen en virkedag.