Први кораци
Грешке
Када нешто пође наопако, 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. Остале грешке захтевају исправку у захтеву или у кључу.