Felkoder
ErrorInformation, HTTP-status och Klirrs felkoder.
Resursendpoints (/3/...) svarar med Fortnox felkuvert. Meddelandet är på svenska.
{
"ErrorInformation": {
"Error": 1,
"Message": "Kan inte hitta kunden",
"Code": 9000404
}
}| Fält | Beskrivning |
|---|---|
Error | Alltid 1. En flagga, inte en felkod. |
Message | Läsbart meddelande på svenska. |
Code | Sjusiffrig felkod, se nedan. |
Felkoderna ligger i ett eget Klirr-intervall (9000xxx) och krockar aldrig med Fortnox egna nummer. Mappa på Code eller HTTP-status. Fel-svar cachas aldrig (Cache-Control: no-store).
Koder
Code | HTTP | Betydelse | Vad du gör |
|---|---|---|---|
9000400 | 400 | Felaktig begäran: trasig JSON, saknat kuvert, ogiltigt fält, ostödd parameter. | Rätta begäran. Försök inte igen oförändrat. |
9000401 | 401 | Authorization saknas, token ogiltigt, utgånget eller återkallat. | Förnya token. Om förnyelsen ger invalid_grant: låt användaren godkänna igen. |
9000403 | 403 | Scope saknas, eller organisationen saknar AI Pro. Även andra behörighets- och kvotfel. | Ändra inte begäran. Begär rätt scope eller låt organisationen uppgradera. |
9000404 | 404 | Resursen finns inte. Meddelandet säger vilken resurs. | |
9000409 | 409 | Resursens tillstånd hindrar operationen, t.ex. en bokförd faktura som måste krediteras i stället. | Byt väg; payloaden är inte fel. |
9000429 | 429 | Rate limit. Svaret har Retry-After. | Vänta och försök igen. |
9000500 | 500 | Internt fel. | Försök igen med backoff. |
Vanliga meddelanden
| Meddelande | Status |
|---|---|
Authorization-headern saknas eller är felformad | 401 |
Ogiltig access token | 401 |
Access token har gått ut | 401 |
Åtkomsten är återkallad | 401 |
Scope saknas för anropet: <scope> | 403 |
Det externa API:et ingår i AI Pro och uppåt. ... | 403 |
Kunde inte tolka anropets JSON-kropp | 400 |
Fältet <Resurs> saknas i anropet | 400 |
Fältet <Resurs> måste vara ett objekt | 400 |
För många anrop | 429 |
Internt serverfel | 500 |
Resursspecifika fel står på varje referenssida.
OAuth-endpoints
/api/v1/oauth-v1/* svarar i stället enligt RFC 6749: {"error": "...", "error_description": "..."}. Se Autentisering.