PUBLIC API · v1
ДОКУМЕНТАЦИЯ

Ошибки и повторы

HTTP-статусы, коды ошибок и безопасные повторы.

API https://api.reduxhub.ru/public/v1

DL https://dl.reduxhub.ru

Только справка · запросов нет

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-статус, но не ключи, тела с секретами или ссылки на скачивание.

ReduxHub Developers · API 1.0.0