Помилки
Кожна відповідь з помилкою має ті самі три поля:
{ "code": "quota_exceeded", "message": "The creator plan includes 200 posts this month; 200 are in use.", "hint": "Upgrade the plan at https://app.dropslate.top/settings/billing."}message констатує факт із запиту чи мережі дослівно — це опис, а не те, за чим зіставляти шаблон. hint каже, що з цим робити. code — стабільна частина — він не змінює значення між релізами, тож перевіряйте його, а не лише HTTP-статус (кілька кодів ділять статус: і insufficient_scope, і forbidden — 403, але означають різне).
Наскрізні коди
Section titled “Наскрізні коди”Вони не привʼязані до одного маршруту — можуть повернутися з більшості API.
| Код | HTTP | Значення |
|---|---|---|
unauthenticated |
401 | Немає дійсного ключа чи сесії. |
key_and_session |
401 | Надіслано і ключ, і cookie сесії. |
insufficient_scope |
403 | Credential бракує scope, потрібного маршруту. |
forbidden |
403 | Роль користувача з входом не дозволяє цю дію (див. Учасники й ролі). |
not_found |
404 | Ресурс не існує — включно з тим, що належить іншому workspace, який відповідає точно так само, як ніколи не створений. |
confirm_required |
409 | POST /posts викликано без confirm: true (єдиний REST-маршрут із такими воротами — див. Повтор і скасування, чому повтор/скасування/перепланування їх не мають). |
quota_exceeded |
402 | Понад ліміт тарифу для цього ресурсу — див. Тарифи й ліміти. |
rate_limited |
429 | Забагато запитів — див. Обмеження частоти. |
Коди перевірки конкретних маршрутів (caption_too_long, video_too_large, invalid_timezone, publish_in_past та інші) задокументовані на маршруті, що їх повертає, у довіднику OpenAPI і так само зʼявляються в таблиці dropslate_plan_post.