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

Результат операции

GET/api/v1/vpn/operations/{custom_id}

Что стало с денежной операцией: in_progress (ещё выполняется), done (готово, ответ в result) или failed (отказ, тело в error, тот же custom_id можно повторить). Ничего не меняет и денег не списывает: годится для восстановления после потерянного ответа или перезапуска вашего сервера. 404 operation_not_found значит, что запрос до нас не дошёл.

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

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

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

Ваш custom_id операции.

Поля ответа

successboolean

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

operationobject

Операция по вашему custom_id.

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

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

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

404operation_not_found: Операция с таким custom_id не найдена

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

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

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

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

API-ключ

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

custom_id*

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

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

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

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

{
  "success": true,
  "operation": {
    "custom_id": "11111111-1111-4111-8111-111111111111",
    "operation": "subscription.create",
    "status": "done",
    "http_status": 201,
    "subscription_id": "01a06315-1270-705a-8d4c-58fea607bf2c",
    "error_code": null,
    "created_at": "2026-09-02T12:00:00Z",
    "updated_at": "2026-09-02T12:00:01Z",
    "result": {
      "success": true,
      "custom_id": "11111111-1111-4111-8111-111111111111",
      "subscription": {
        "subscription_id": "01a06315-1270-705a-8d4c-58fea607bf2c",
        "client_id": "01a06310-8f2b-7c11-9a3e-2b5c7d9e1f00",
        "external_user_id": "user-42",
        "telegram_id": null,
        "bot_id": null,
        "source": "api",
        "plan_uuid": "550e8400-e29b-41d4-a716-446655440000",
        "plan_name": "Standard 30d",
        "is_trial": false,
        "product": "term",
        "is_lifetime": false,
        "status": "active",
        "subscription_url": "https://api.relayhub.surf/sub/wnT9NRf0Zk6McRRnp2nggc3K",
        "days": 30,
        "days_left": 30,
        "devices": 2,
        "traffic_limit_bytes": null,
        "auto_renew": false,
        "renewal_count": 0,
        "renewal_progress": 0,
        "created_at": "2026-09-02T12:00:00Z",
        "end_date": "2026-10-02T12:00:00Z",
        "frozen_at": null,
        "price_minor": 450,
        "price_usd": "4.50"
      },
      "charged_minor": 450,
      "charged_usd": "4.50",
      "balance_after_minor": 11600,
      "balance_after_usd": "116.00"
    },
    "error": null
  }
}