ДОКУМЕНТАЦИЯ
Ошибки и повторы
HTTP-статусы, коды ошибок и безопасные повторы.
HTTP-статусы#
| HTTP | Действие клиента |
|---|---|
| 400 | Исправьте параметры/тело по схеме. |
| 401 | Проверьте тип, срок действия и отзыв ключа или токена. API не перенаправляет на HTML-страницу входа. |
| 403 | Проверьте область доступа, согласие, роль и владельца ресурса. |
| 404 | Ресурс отсутствует или недоступен этому пользователю. |
| 409 | Проверьте конфликт и смещение Upload-Offset. Перед повторной записью уточните состояние ресурса. |
| 410 | Сессия загрузки или ссылка на скачивание истекла. Сначала выясните результат предыдущей операции. |
| 413 | Тело запроса или часть файла превышает лимит. Уменьшите размер перед повтором. |
| 415 | Неподдерживаемый тип или кодирование тела. Части файла передаются как application/octet-stream без сжатия. |
| 422 | Доменная валидация отклонила контент там, где такой статус определён. Исправьте данные/архив. |
| 429 | Следуйте Retry-After; квота общая. |
| 503 | Для чтения — ограниченные повторы с увеличением задержки. Для записи сначала проверьте результат предыдущей операции. |
Записанные ответы ошибок#
HTTP-ответы записаны в локальной тестовой среде. Идентификаторы запросов меняются. OAuth возвращает JSON без обёртки, остальные операции — с обёрткой API.
401 · неверный ключ
GET /public/v1/mods
HTTP response
HTTP/1.1 401
x-request-id: 503ef036-d2a8-4b0c-a5e9-4e8855bb68d5
cache-control: no-store
content-type: application/json; charset=utf-8
{
"success": false,
"error": {
"code": "API_BEARER_REQUIRED",
"message": "Use a developer key or a delegated user token"
},
"meta": {
"requestId": "503ef036-d2a8-4b0c-a5e9-4e8855bb68d5"
}
}400 · неверный параметр
GET /public/v1/mods?limit=bad
HTTP response
HTTP/1.1 400
ratelimit-limit: 60
ratelimit-remaining: 57
ratelimit-reset: 60
x-request-id: 3a4f6daf-08df-4f43-903b-22e17ff4b485
cache-control: no-store
x-quota-limit: 10000
x-quota-remaining: 9996
x-quota-reset: 1797148615
content-type: application/json; charset=utf-8
{
"success": false,
"error": {
"code": "INVALID_ID",
"message": "Request rejected"
},
"meta": {
"requestId": "3a4f6daf-08df-4f43-903b-22e17ff4b485"
}
}403 · недостаточно прав
POST /public/v1/upload-sessions
HTTP response
HTTP/1.1 403
x-request-id: 7a4b2f07-a816-42ca-8b8f-33b1290b6988
cache-control: no-store
content-type: application/json; charset=utf-8
{
"success": false,
"error": {
"code": "API_SCOPE_REQUIRED",
"message": "Credential lacks the required public scope"
},
"meta": {
"requestId": "7a4b2f07-a816-42ca-8b8f-33b1290b6988"
}
}404 · ресурс не найден
GET /public/v1/mods/2147483647
HTTP response
HTTP/1.1 404
ratelimit-limit: 60
ratelimit-remaining: 56
ratelimit-reset: 60
x-request-id: 51456789-06cd-426b-8c4b-424e25becc03
cache-control: no-store
x-quota-limit: 10000
x-quota-remaining: 9996
x-quota-reset: 1797148615
content-type: application/json; charset=utf-8
{
"success": false,
"error": {
"code": "MOD_NOT_FOUND",
"message": "Request rejected"
},
"meta": {
"requestId": "51456789-06cd-426b-8c4b-424e25becc03"
}
}OAuth · ошибка обмена кода
POST /public/v1/oauth/token
HTTP response
HTTP/1.1 400
x-request-id: f1e15906-6833-4a18-9b82-6a395e97ba09
cache-control: no-store
pragma: no-cache
content-type: application/json; charset=utf-8
{
"error": "invalid_grant",
"error_description": "Token request rejected"
}Записывайте идентификатор запроса, время UTC, метод и HTTP-статус, но не ключи, тела с секретами или ссылки на скачивание.