Први кораци

Грешке

Када нешто пође наопако, API враћа одговарајући HTTP статус и тело са code и message унутар error.

У свом програму користите code. message је текст на енглеском који помаже при отклањању грешака и може да се промени.

Формат грешке404
{
  "error": {
    "code": "not_found",
    "message": "Item not found or you do not have access to it."
  }
}
Без кључа401
{
  "error": {
    "code": "missing_api_key",
    "message": "Send your API key in the X-API-Key header or as Authorization: Bearer <key>."
  }
}

Кодови грешака

Статус Код Када се јавља
400 key_in_query Кључ је послат у адреси (параметри api_key, apikey, key или token). Шаљите га у заглављу и направите нови кључ, јер је претходни можда остао записан у логовима.
400 invalid_parameter Неки параметар има неважећу вредност, нпр. per_page изнад максимума.
401 missing_api_key Захтев не садржи кључ.
401 invalid_api_key Кључ не постоји, опозван је или је његов корисник деактивиран.
404 not_found Ендпоинт не постоји, или ставка не постоји или припада организацији коју корисник не може да види.
404 organization_not_found Наведени organization није организација у којој корисник може да види ову врсту ставки.
405 method_not_allowed API прихвата само GET (и HEAD).
429 rate_limited Ограничење захтева је достигнуто. Сачекајте број секунди из Retry-After.
500 server_error Интерна грешка. Покушајте поново за неколико тренутака; ако се понови, контактирајте подршку.

Када поновити захтев

Исти захтев има смисла поновити само после 429 (уз чекање на Retry-After) или 500. Остале грешке захтевају исправку у захтеву или у кључу.