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

Состояние сети

GET/api/v1/vpn/network

Страны и серверы сети с живым статусом: тот же мониторинг, что на странице статуса в кабинете. Серверы пингуем раз в несколько минут (checked_at), список стран обновляется у поставщика (synced_at). Данные общие для всех, кэшируйте на минуту: чаще они не меняются.

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

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

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

Чья сеть: term тарифов на срок или lifetime «Навсегда». У них разные серверы.

одно из:termlifetime

Поля ответа

successboolean

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

sectionstring

Чья сеть, как в запросе: term или lifetime.

availableboolean

false: сеть «Навсегда» сейчас не работает у платформы, остальных полей тогда нет.

statusstring

Состояние сети сейчас: operational работает, degraded часть серверов не отвечает, down не работает, no_data замеров ещё нет.

uptime_pct_90dnumber | null

Доступность сети за 90 дней в процентах; null, пока замеров нет.

countries_totalinteger

Сколько стран в сети.

servers_totalinteger

Сколько серверов в сети.

servers_upinteger

Сколько из них ответили на последнюю проверку.

synced_atstring | null

Когда список серверов последний раз обновлялся у поставщика, ISO 8601.

checked_atstring | null

Когда серверы последний раз проверяли, ISO 8601. Проверка раз в несколько минут.

countriesobject[]

Страны сети, внутри серверы.

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

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

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

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

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

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

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

API-ключ

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

section

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

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

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

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

{
  "success": true,
  "section": "term",
  "available": true,
  "status": "operational",
  "uptime_pct_90d": 99.71,
  "countries_total": 16,
  "servers_total": 42,
  "servers_up": 41,
  "synced_at": "2026-10-31T09:00:12+00:00",
  "checked_at": "2026-10-31T12:55:03+00:00",
  "countries": [
    {
      "country_code": "DE",
      "name": "Германия",
      "flag": "🇩🇪",
      "region": "Европа",
      "servers_up": 3,
      "servers_total": 3,
      "servers": [
        {
          "name": "🇩🇪 Frankfurt 1",
          "up": true,
          "latency_ms": 41
        }
      ]
    }
  ]
}