Инструкция по API

Начало работы

API позволяет получать источники 3x-ui, создавать итоговые подписки, назначать им источники, изменять срок действия и активность, а также удалять подписки.

Получение ключа

1. Вернитесь в административную панель.
2. Откройте раздел Настройки → API-ключи.
3. Заполните отдельное поле Комментарий — назначение ключа.
4. Нажмите Создать API-ключ, скопируйте и сохраните значение: оно показывается только один раз.

Можно создавать несколько независимых ключей. У каждого — комментарий, статус, даты создания, обновления и последнего использования. Комментарий можно редактировать. Отозвать закрывает доступ только по выбранному ключу. Перевыпустить заменяет выбранный ключ (в том числе отозванный); остальные остаются действующими. Старый ключ системы сохраняется.

Управление администратором с JWT: GET /api/settings/api-keys; POST туда же с JSON {"comment":"CRM"}; PATCH /api/settings/api-keys/{id} для комментария; POST /api/settings/api-keys/{id}/rotate для перевыпуска; DELETE /api/settings/api-keys/{id} для отзыва.

Авторизация

Каждый запрос к /api/v1/* должен содержать заголовок Bearer. Для запросов с телом добавьте Content-Type: application/json.

Authorization: Bearer dws_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

Получение ID источников

Перед созданием подписки запросите числовые ID доступных источников.

curl -sS https://subs.dadway.ru/api/v1/sources \
  -H "Authorization: Bearer $API_TOKEN"

Ответ содержит id, unique_id, название, площадку region (msk или spb), URL, порядок сортировки, статус и срок каждого источника.

Создание итоговой подписки

curl -sS -X POST https://subs.dadway.ru/api/v1/subscriptions \
  -H "Authorization: Bearer $API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Клиент №1",
    "environment": "test",
    "region": "msk",
    "public_id": "client-001",
    "remark": "dadway.ru",
    "cost": 1490.00,
    "active": true,
    "expires_at": "2026-12-31T23:59:59Z",
    "update_interval_hours": 1,
    "hwid_mode": "audit",
    "hwid_limit": 0
  }'

Минимальное тело запроса: {"name":"Новая подписка"}. Будет выбрана площадка all, назначены все источники и возвращён готовый public_url.

Получение и изменение подписки

Продлить срок

curl -sS -X PATCH \
  https://subs.dadway.ru/api/v1/subscriptions/client-001/expiration \
  -H "Authorization: Bearer $API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"expires_at":"2027-01-31T23:59:59Z"}'

Заблокировать

curl -sS -X PATCH \
  https://subs.dadway.ru/api/v1/subscriptions/client-001/status \
  -H "Authorization: Bearer $API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"active":false}'

Заменить источники

curl -sS -X PUT \
  https://subs.dadway.ru/api/v1/subscriptions/client-001/sources \
  -H "Authorization: Bearer $API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"source_ids":[2,3,7]}'

Все указанные источники должны соответствовать region итоговой подписки; для all разрешены обе площадки.

Контроль устройств по HWID

disabled не требует HWID; audit считает устройства без блокировки; enforce закрывает выдачу без X-HWID, при превышении лимита или ручной блокировке.

Включить аудит или контроль

curl -sS -X PATCH \
  https://subs.dadway.ru/api/v1/subscriptions/client-001/hwid-limit \
  -H "Authorization: Bearer $API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode":"audit","limit":0}'

Публичный запрос клиента

curl -sS https://subs.dadway.ru/sub/client-001 \
  -H "X-HWID: stable-device-identifier"

Удаление подписки

curl -sS -X DELETE \
  https://subs.dadway.ru/api/v1/subscriptions/client-001 \
  -H "Authorization: Bearer $API_TOKEN"

Успешный ответ: 204 No Content. Публичная ссылка перестаёт существовать.

Коды ответов