ДОКУМЕНТАЦИЯ
Быстрый старт
Запрос каталога на cURL, Node.js и Python.
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 относится к документации: названия и описания авторов возвращаются на исходном языке, автоматического перевода нет.