Kom igång

Fel

När något går fel svarar API:et med motsvarande HTTP-status och en body med code och message inuti error.

Använd code i ditt program. message är en engelsk text som ska hjälpa den som felsöker, och den kan ändras.

Felformat404

{
  "error": {
    "code": "not_found",
    "message": "Item not found or you do not have access to it."
  }
}

Ingen nyckel401

{
  "error": {
    "code": "missing_api_key",
    "message": "Send your API key in the X-API-Key header or as Authorization: Bearer <key>."
  }
}

Felkoder

Status	Kod	När det inträffar
400	`key_in_query`	Nyckeln skickades i URL:en (parametrarna `api_key`, `apikey`, `key` eller `token`). Skicka den i headern och generera en ny nyckel, eftersom den tidigare kan ha sparats i loggar.
400	`invalid_parameter`	En parameter har ett ogiltigt värde, till exempel `per_page` över maxvärdet.
401	`missing_api_key`	Anropet innehöll ingen nyckel.
401	`invalid_api_key`	Nyckeln finns inte, har återkallats eller så är dess användare inaktiverad.
404	`not_found`	Endpointen finns inte, eller så finns objektet inte eller tillhör en organisation som användaren inte kan se.
404	`organization_not_found`	Angiven `organization` är inte en organisation där användaren kan se den här typen av objekt.
405	`method_not_allowed`	API:et accepterar bara `GET` (och `HEAD`).
429	`rate_limited`	Anropsgränsen har nåtts. Vänta det antal sekunder som anges i `Retry-After`.
500	`server_error`	Internt fel. Försök igen om en stund. Kontakta support om felet kvarstår.

Upprepa samma anrop bara efter en 429 (när du har väntat enligt Retry-After) eller en 500. Andra fel kräver att anropet eller nyckeln rättas.