Заморозить

POST/api/v1/vpn/subscriptions/{subscription_id}/freeze

Срок останавливается, конфиг не отдаётся. Повтор по уже замороженной вернёт 409 subscription_state.

curl -X POST https://api.relayhub.surf/api/v1/vpn/subscriptions/<subscription_id>/freeze \
  -H "Authorization: Bearer <YOUR_API_KEY>"
Вставьте свой ключ в меню, и он подставится вместо <YOUR_API_KEY>.
{
  "success": true,
  "subscription": {
    "subscription_id": "01a06315-1270-705a-8d4c-58fea607bf2c",
    "external_user_id": "user-42",
    "plan_uuid": "550e8400-e29b-41d4-a716-446655440000",
    "plan_name": "Standart 30d",
    "is_trial": false,
    "status": "frozen",
    "subscription_url": "https://api.relayhub.surf/sub/wnT9NRf0Zk6McRRnp2nggc3K",
    "days": 30,
    "days_left": 30,
    "devices": 2,
    "auto_renew": false,
    "renewal_count": 0,
    "created_at": "2026-09-02T12:00:00Z",
    "end_date": "2026-10-02T12:00:00Z",
    "frozen_at": "2026-09-10T08:00:00Z",
    "price_minor": 450,
    "price_usd": "4.50"
  }
}

Авторизация

Заголовок Authorization: Bearer <ключ> на каждом запросе. Ключ один на аккаунт, выпускается в кабинете партнёра и показывается один раз. Он тратит депозит: держите его на сервере.

Поля ответа

successbooleanобязательно
subscriptionobjectобязательно

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

401unauthorized: Неверный или отсутствующий API-ключ
403api_disabled: Доступ к API для этого аккаунта закрыт
404subscription_not_found: Подписка не найдена
409subscription_state: Операция не подходит к текущему состоянию подписки; trial_not_freezable: Пробную подписку нельзя заморозить
422Validation Error
429rate_limited: Слишком много запросов
503upstream_unavailable: Поставщик VPN временно недоступен
Собираем анонимную аналитику посещений. Подробнее