Ваш сайт или программа сама выдаёт подписки из нашего VPN. Нужен разработчик.

Удалить устройство

DEL/api/v1/vpn/subscriptions/{subscription_id}/devices/{device_id}

Освобождает слот. По умолчанию ещё и отключает устройство: переустановка VPN-клиента не помогает, идентификатор устройства остаётся тем же. Вернуть его можно через DELETE /subscriptions/{id}/devices/blocked/{block_id}.

Авторизация и общие правила

Параметры пути

subscription_idобязательно

Идентификатор подписки: subscription.subscription_id из ответа покупки или списка.

device_idобязательно

Номер устройства: id из GET /subscriptions/{id}/devices.

Параметры запроса

blockнеобязательно

true: освободить слот и отключить устройство, по этой ссылке оно больше не получит конфиг. false: только освободить слот, устройство подключится заново.

Поля ответа

successboolean

true у любого успешного ответа.

subscription_iduuid

Идентификатор подписки.

device_idinteger

Удалённое устройство.

blockedboolean

Устройство отключено: по этой ссылке оно больше не получит конфиг. false при block=false или если такой же идентификатор есть у другого устройства подписки.

Когда откажет

401unauthorized: Неверный или отсутствующий API-ключ

403api_disabled: Доступ к API для этого аккаунта закрыт; ip_not_allowed: Адрес запроса не входит в список разрешённых

404subscription_not_found: Подписка не найдена; device_not_found: Устройство не найдено

409unsupported_for_product: Это действие не подходит к этому виду подписки

422validation_error: Неверные параметры запроса

429rate_limited: Слишком много запросов

503upstream_unavailable: Поставщик VPN временно недоступен

Попробовать запрос

API-ключ

Подставится в примеры и в запрос. Хранится только в этом браузере.

subscription_id*device_id*block

curl -X DELETE https://api.relayhub.surf/api/v1/vpn/subscriptions/<subscription_id>/devices/<device_id> \
  -H "Authorization: Bearer <YOUR_API_KEY>"

Вставьте свой ключ, и он подставится вместо <YOUR_API_KEY>.

Запрос меняет данные или списывает деньги: выполняйте его из своего кода.

Пример ответа

{
  "success": true,
  "subscription_id": "01a06315-1270-705a-8d4c-58fea607bf2c",
  "device_id": 7,
  "blocked": true
}