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

Устройства подписки

GET/api/v1/vpn/subscriptions/{subscription_id}/devices

Устройства, подключавшие конфиг, у подписки любого вида, и на срок, и «Навсегда». Лимит задаёт тариф (devices в подписке). last_seen у «Навсегда» это последнее обновление конфига устройством.

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

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

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

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

Поля ответа

successboolean

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

subscription_iduuid

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

devicesobject[]

Устройства, подключавшие конфиг.

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

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

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

404subscription_not_found: Подписка не найдена

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

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

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

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

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

API-ключ

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

subscription_id*

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

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

Вставьте API-ключ

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

{
  "success": true,
  "subscription_id": "01a06315-1270-705a-8d4c-58fea607bf2c",
  "devices": [
    {
      "id": 7,
      "hwid": "9f2a6c1e-iphone",
      "name": "iPhone 15",
      "os": "iOS",
      "model": "iPhone15,2",
      "os_version": "18.5",
      "ip": "203.0.113.7",
      "first_seen": "2026-09-02T12:05:00+00:00",
      "last_seen": "2026-09-02T18:40:00+00:00"
    }
  ]
}