API-dokumentation v1
Dansk
Dokumentationens sprog Kodeeksempler og feltnavne er de samme på alle sprog.
Gå til kontrolpanelet

Kom godt i gang

Fejl

Når noget går galt, svarer API'et med den tilsvarende HTTP-status og en body med code og message inde i error.

Brug code i dit program. message er en engelsk tekst, der skal hjælpe den, der fejlsøger, og den kan blive ændret.

Fejlformat404
{
  "error": {
    "code": "not_found",
    "message": "Item not found or you do not have access to it."
  }
}
Ingen nøgle401
{
  "error": {
    "code": "missing_api_key",
    "message": "Send your API key in the X-API-Key header or as Authorization: Bearer <key>."
  }
}

Fejlkoder

Status Kode Hvornår det sker
400 key_in_query Nøglen blev sendt i URL'en (parametrene api_key, apikey, key eller token). Send den i headeren, og generér en ny nøgle, da den gamle kan være blevet gemt i logfiler.
400 invalid_parameter En parameter har en ugyldig værdi, f.eks. per_page over maksimum.
401 missing_api_key Forespørgslen indeholdt ingen nøgle.
401 invalid_api_key Nøglen findes ikke, er blevet tilbagekaldt, eller dens bruger er deaktiveret.
404 not_found Endpointet findes ikke, eller elementet findes ikke eller tilhører en organisation, som brugeren ikke kan se.
404 organization_not_found Den angivne organization er ikke en organisation, hvor brugeren kan se denne type elementer.
405 method_not_allowed API'et accepterer kun GET (og HEAD).
429 rate_limited Grænsen for forespørgsler er nået. Vent det antal sekunder, der står i Retry-After.
500 server_error Intern fejl. Prøv igen om lidt. Hvis fejlen fortsætter, så kontakt support.

Hvornår du skal prøve igen

Gentag kun den samme forespørgsel efter en 429 (når du har ventet den tid, der står i Retry-After) eller en 500. Andre fejl kræver, at forespørgslen eller nøglen rettes.