Prvi koraci

Greške

Kada nešto pođe po zlu, API vraća odgovarajući HTTP status i tijelo s code i message unutar error.

U svom programu koristite code. message je tekst na engleskom koji pomaže pri otklanjanju grešaka i može se promijeniti.

Format greške404

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

Bez ključa401

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

Kodovi grešaka

Status	Kod	Kada se javlja
400	`key_in_query`	Ključ je poslan u adresi (parametri `api_key`, `apikey`, `key` ili `token`). Šaljite ga u zaglavlju i kreirajte novi ključ, jer je prethodni možda ostao zapisan u logovima.
400	`invalid_parameter`	Neki parametar ima nevažeću vrijednost, npr. `per_page` iznad maksimuma.
401	`missing_api_key`	Zahtjev ne sadrži ključ.
401	`invalid_api_key`	Ključ ne postoji, opozvan je ili je njegov korisnik deaktiviran.
404	`not_found`	Endpoint ne postoji, ili stavka ne postoji ili pripada organizaciji koju korisnik ne može vidjeti.
404	`organization_not_found`	Navedeni `organization` nije organizacija u kojoj korisnik može vidjeti ovu vrstu stavki.
405	`method_not_allowed`	API prihvata samo `GET` (i `HEAD`).
429	`rate_limited`	Ograničenje zahtjeva je dostignuto. Sačekajte broj sekundi iz `Retry-After`.
500	`server_error`	Interna greška. Pokušajte ponovo za nekoliko trenutaka; ako se ponovi, kontaktirajte podršku.

Kada ponoviti zahtjev

Isti zahtjev ima smisla ponoviti samo nakon 429 (uz čekanje na Retry-After) ili 500. Ostale greške zahtijevaju ispravku u zahtjevu ili u ključu.