/api/v1/vpn/subscriptions/{subscription_id}/devicesУстройства, подключавшие конфиг. Лимит задаёт тариф (devices в подписке).
curl https://api.relayhub.surf/api/v1/vpn/subscriptions/<subscription_id>/devices \
-H "Authorization: Bearer <YOUR_API_KEY>"{
"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"
}
]
}Заголовок Authorization: Bearer <ключ> на каждом запросе. Ключ один на аккаунт, выпускается в кабинете партнёра и показывается один раз. Он тратит депозит: держите его на сервере.
successbooleanобязательноsubscription_idstringобязательноdevicesobject[]обязательно401unauthorized: Неверный или отсутствующий API-ключ403api_disabled: Доступ к API для этого аккаунта закрыт404subscription_not_found: Подписка не найдена422Validation Error429rate_limited: Слишком много запросов503upstream_unavailable: Поставщик VPN временно недоступенcurl https://api.relayhub.surf/api/v1/vpn/subscriptions/<subscription_id>/devices \
-H "Authorization: Bearer <YOUR_API_KEY>"{
"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"
}
]
}