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

Быстрый старт

Запрос каталога на cURL, Node.js и Python.

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

DL https://dl.reduxhub.ru

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

1. Создайте ключ#

  • В кабинете /account/developer подключите API-план, создайте проект и ключ с областью доступа catalog:read. Полный секрет показывается один раз. Контент-подписка не заменяет API-план.
  • Сохраните ключ на сервере в переменной окружения REDUXHUB_API_KEY.
  • Примеры используют локальный API: 127.0.0.1:1335. Для работы с зеркалом замените этот адрес в коде клиента на адрес из раздела «Домены и зеркала». Локальный API запускается отдельно от документации.

2. Получите каталог#

GET /mods?limit=1 требует catalog:read и расходует одну единицу квоты. Выберите клиент:

cURL
cURL
API_BASE="http://127.0.0.1:1335/public/v1"
: "${REDUXHUB_API_KEY:?Set your server-side developer key}"
curl --fail-with-body --max-time 15 \
  -H "Authorization: Bearer $REDUXHUB_API_KEY" \
  -H "Accept: application/json" \
  "$API_BASE/mods?limit=1"
JavaScript · Node.js
JavaScript · Node.js
// Node.js: keep the key in the server environment, not browser storage.
const apiKey = process.env.REDUXHUB_API_KEY;
if (!apiKey) throw new Error("Set REDUXHUB_API_KEY");
const response = await fetch("http://127.0.0.1:1335/public/v1/mods?limit=1", {
  headers: { Authorization: "Bearer " + apiKey, Accept: "application/json" },
  redirect: "error",
  signal: AbortSignal.timeout(15000),
});
const result = await response.json();
if (!response.ok) throw new Error("HTTP " + response.status + ": " + result.error?.code);
console.log(result);
Python
Python
import json, os, urllib.request, urllib.error

class NoRedirect(urllib.request.HTTPRedirectHandler):
    def redirect_request(self, req, fp, code, msg, headers, newurl):
        return None

key = os.environ["REDUXHUB_API_KEY"]
opener = urllib.request.build_opener(urllib.request.ProxyHandler({}), NoRedirect())
request = urllib.request.Request(
    "http://127.0.0.1:1335/public/v1/mods?limit=1",
    headers={"Authorization": "Bearer " + key, "Accept": "application/json"},
)
try:
    with opener.open(request, timeout=15) as response:
        print(json.load(response))
except urllib.error.HTTPError as error:
    print("HTTP", error.code)  # Never print the key or a download ticket.

3. Прочитайте ответ#

GET /public/v1/mods?limit=1

HTTP response
HTTP/1.1 200
ratelimit-limit: 60
ratelimit-remaining: 59
ratelimit-reset: 60
x-request-id: b66165a1-110a-4909-a281-6faffa7432d9
cache-control: no-store
x-quota-limit: 10000
x-quota-remaining: 9997
x-quota-reset: 1797148615
content-type: application/json; charset=utf-8

{
  "success": true,
  "data": {
    "items": [
      {
        "id": 2,
        "name": "Example graphics preset",
        "description": "Local documentation test fixture",
        "category": "redux",
        "type": "graphics",
        "version": "legacy",
        "project": "community",
        "accessType": "free",
        "price": {
          "amountMinor": 0,
          "currency": "RUB"
        },
        "publisherId": 1,
        "previewUrl": null,
        "downloads": 0,
        "verified": false,
        "createdAt": "2026-11-13T07:56:59.000Z",
        "updatedAt": "2026-11-13T07:56:59.000Z",
        "url": "http://localhost:5177/trigande/2"
      }
    ],
    "pagination": {
      "limit": 1,
      "nextCursor": "eyJ2IjoxLCJraW5kIjoibW9kcyIsImYiOiI0ZjUzY2RhMThjMmJhYTBjMDM1NGJiNWYiLCJpZCI6Mn0"
    }
  },
  "meta": {
    "requestId": "b66165a1-110a-4909-a281-6faffa7432d9",
    "apiVersion": "v1"
  }
}

Моды находятся в data.items. data.pagination.nextCursor передайте как cursor вместе с прежними фильтрами и limit; не разбирайте и не изменяйте cursor. null означает конец списка. meta.requestId используйте для диагностики.

4. Квота и следующий запрос#

  • X-Quota-Limit и X-Quota-Remaining — единицы периода; X-Quota-Reset — время Unix в секундах. RateLimit-Reset — длительность окна ограничения частоты в секундах, не время Unix.
  • GET /me/usage требует usage:read и не расходует единицы квоты, но участвует в общем RPM-лимите аккаунта.
  • При ошибке используйте HTTP-статус и error.code; для OAuth /oauth/token формат отдельный, стандартный OAuth JSON. Примеры фактических ошибок приведены на странице «Ошибки и повторы».
  • RU/EN относится к документации: названия и описания авторов возвращаются на исходном языке, автоматического перевода нет.

ReduxHub Developers · API 1.0.0