Kom i gang

Fejl

Samme form hver gang. Skriv dit if på error.code — den er stabil.

Fejl har altid den samme form. Skriv dit if på error.code — den er stabil. Teksten i message er til den, der fejlsøger, og kan blive omformuleret.

JSON

{
  "error": {
    "code": "insufficient_scope",
    "message": "This key is missing the \"services:write\" scope."
  }
}

Koderne

Kode	Status	Hvad det betyder	Det du gør
`invalid_request`	400	Et felt mangler, er for langt eller har den forkerte type.	Læs `error.message` — den nævner feltet ved navn.
`unauthorized`	401	Ingen nøgle, en ukendt nøgle, eller en der er tilbagekaldt.	Tjek Authorization-headeren. En kopieret nøgle slæber ofte et mellemrum med — det trimmer vi, men en afkortet nøgle kan vi ikke redde.
`insufficient_scope`	403	Nøglen er gyldig, men mangler det scope, endepunktet kræver.	Beskeden nævner det manglende scope. Sæt fluebenet på nøglen, eller opret en ny.
`account_suspended`	403	Nøglen er gyldig — kontoen er lukket. Enten suspenderet eller opsagt.	En ny nøgle hjælper ikke; det er ikke nøglen, der fejler. Skriv til os, så siger vi hvorfor og hvad der skal til.
`not_found`	404	Der er ingen række med det id — i din organisation.	Vi siger aldrig, om id'et findes et andet sted. Hold id'et op mod et listekald.
`conflict`	409	Forespørgslen var rigtig, men virkeligheden sagde nej — tidspunktet er optaget, eller behandleren er der ikke.	Hent tilstanden igen og vis kunden, hvad der faktisk er ledigt.
`rate_limited`	429	For mange kald i det her minut.	Vent til `X-RateLimit-Reset`. Se Grænser og sider.
`route_not_configured`	500	Vores fejl: et endepunkt uden en scope-kortlægning.	Skriv til os — den skal rettes hos os, ikke hos dig.
`server_error`	500	Noget gik i stykker hos os.	Prøv igen med en voksende pause. Bliver den ved, så skriv.

Tre forskellige 403'ere. insufficient_scope og account_suspended ser ens ud i
statuskoden, men kræver hver sin handling — den ene retter du selv på nøglen, den anden
kan kun vi løse.