DadwaySubs API — инструкция

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

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

Базовый адрес

https://subs.dadway.ru

Интерактивная схема

/docs — Swagger UI

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

Вернитесь в административную панель.
Откройте раздел Настройки.
Нажмите Сгенерировать API-токен.
Скопируйте и сохраните токен: полное значение показывается только один раз.

Авторизация

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

Authorization: Bearer dws_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

Не передавайте API-токен в URL и не сохраняйте его в Git. Перевыпуск токена немедленно отключает предыдущий.

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

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

GET/api/v1/sources

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

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

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

POST/api/v1/subscriptions

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

Поле	Обязательно	Описание
`name`	Да	Название, до 120 символов
`environment`	Нет	`prod` или `test`; по умолчанию `test`
`region`	Нет	`msk`, `spb` или `all`; по умолчанию `all`
`public_id`	Нет	Уникальный ID; если не указан, генерируется автоматически
`remark`	Нет	Примечание при импорте, по умолчанию `dadway.ru`
`cost`	Нет	Справочная стоимость для отчётов, неотрицательное число с двумя знаками после запятой
`active`	Нет	По умолчанию `true`
`expires_at`	Нет	Дата окончания в ISO 8601 или `null`
`created_at`	Нет	Дата и время создания в ISO 8601; по умолчанию устанавливается текущее время, позднее может быть изменена в панели
`source_ids`	Нет	Если отсутствует — автовыбор по `region`; явные ID должны соответствовать площадке
`update_interval_hours`	Нет	От 1 до 24, по умолчанию 1 час

msk автоматически назначает все источники msk, spb — все источники spb, all — все источники. Явный source_ids может ограничить выбор совместимым подмножеством.

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

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

Метод	Маршрут	Назначение
GET	`/api/v1/subscriptions`	Все подписки
GET	`/api/v1/subscriptions/{public_id}`	Одна подписка
PATCH	`/api/v1/subscriptions/{public_id}/expiration`	Изменить срок
PATCH	`/api/v1/subscriptions/{public_id}/status`	Блокировать или активировать
PUT	`/api/v1/subscriptions/{public_id}/sources`	Полностью заменить список источников

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

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 разрешены обе площадки.

Окончившаяся подписка возвращает пустой ответ 410 Gone. Отключённая подписка возвращает пустой 404 Not Found; источники при этом не запрашиваются.

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

DELETE/api/v1/subscriptions/{public_id}

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

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

Коды ответов

`200 OK`	Запрос выполнен
`201 Created`	Подписка создана
`204 No Content`	Подписка удалена или токен отозван
`401 Unauthorized`	Токен отсутствует или недействителен
`404 Not Found`	Подписка не найдена или отключена
`409 Conflict`	`public_id` уже существует
`410 Gone`	Срок публичной подписки истёк
`422 Unprocessable Entity`	Некорректные поля или ID источников

Важные ограничения

Используйте API только через HTTPS.
Храните токен в переменной окружения или менеджере секретов.
При подозрении на утечку перевыпустите токен в «Настройках».
Блокировка в DadwaySubs закрывает получение и обновление подписки. Уже импортированные VLESS/VMess-ключи необходимо дополнительно отключать на серверах 3x-ui.