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

Делегирование · PKCE

Доступ от имени пользователя с его явного согласия.

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

DL https://dl.reduxhub.ru

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

Authorization Code + S256#

  • Создайте случайный state и случайный code_verifier; длина code_verifier — 43–128 символов. Храните их только на время попытки. challenge = BASE64URL(SHA256(verifier)) без знаков заполнения (=).
  • Откройте /developers/authorize на сайте соответствующего зеркала, не на домене документации или API. Параметры: client_id, redirect_uri, scope (области доступа через пробел), state, code_challenge, code_challenge_method=S256. Заранее зарегистрируйте клиент и точный redirect_uri.
  • Страница показывает проверенное сервером приложение, URI и запрашиваемые области доступа; согласие подтверждается нажатием кнопки. После возврата на redirect_uri сначала проверьте state. Одноразовый code действует 120 секунд.
  • Обменяйте code через POST /oauth/token с grant_type=authorization_code, числовым client_id, code, redirect_uri и code_verifier. Принимаются application/json и application/x-www-form-urlencoded.
  • Токен rh_user_ действует 3600 секунд. Автоматического обновления токена или согласия без подтверждения нет. При загрузке, редактировании и скачивании повторно проверяются выданное разрешение, аккаунт, проект, текущие права, согласие и владелец ресурса.

Расчёт code_challenge на сервере#

JavaScript · Node.js
import { randomBytes, createHash } from "node:crypto";
const verifier = randomBytes(32).toString("base64url");
const state = randomBytes(24).toString("base64url");
const challenge = createHash("sha256").update(verifier).digest("base64url");
// Keep verifier + state in the server-side authorization attempt.
// Pass challenge and state to /developers/authorize, then validate callback state.

Запрос обмена кода#

После согласия пользователя передайте выданный code, исходный code_verifier и зарегистрированный redirect_uri. Переменные ниже содержат значения текущей попытки авторизации.

cURL
curl --fail-with-body --max-time 15 \
  -X POST "http://127.0.0.1:1335/public/v1/oauth/token" \
  --data-urlencode "grant_type=authorization_code" \
  --data-urlencode "client_id=$OAUTH_CLIENT_ID" \
  --data-urlencode "code=$OAUTH_CODE" \
  --data-urlencode "redirect_uri=$OAUTH_REDIRECT_URI" \
  --data-urlencode "code_verifier=$OAUTH_VERIFIER"

Ответы OAuth#

Записанные ответы локального приложения. В успешном ответе скрыт только access_token — секретный токен rh_user_. OAuth возвращает JSON без обёртки success/data/meta. Не сохраняйте токен в браузерном хранилище.

POST /public/v1/oauth/token

HTTP response
HTTP/1.1 200
x-request-id: 0f59bd1c-7dd7-4f88-8fab-4676e5b1068e
cache-control: no-store
pragma: no-cache
content-type: application/json; charset=utf-8

{
  "access_token": "[REDACTED: generated user token]",
  "token_type": "Bearer",
  "expires_in": 3600,
  "scope": "downloads:create"
}

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"
}

ReduxHub Developers · API 1.0.0