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

Журнал доставок

GET/api/v1/vpn/webhook/deliveries

Попытки доставки вебхуков, новые сверху: статус, что ответил ваш сервер, сколько шло. То же, что раздел «Доставки вебхуков» в кабинете.

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

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

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

Фильтр по статусу доставки.

одно из:deliveredfailedpendingdead

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

Фильтр по событию.

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

Сколько пропустить.

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

Размер страницы, до 100.

Поля ответа

successboolean

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

totalinteger

Сколько всего записей под фильтром.

offsetinteger

Сколько записей пропущено, как в запросе.

limitinteger

Размер страницы, как в запросе.

itemsobject[]

Записи страницы.

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

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

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

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

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

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

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

API-ключ

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

statuseventoffsetlimit

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

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

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

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

{
  "success": true,
  "total": 1,
  "offset": 0,
  "limit": 20,
  "items": [
    {
      "delivery_id": "01a06321-0000-7000-8000-000000000002",
      "event": "subscription.expires_in_24h",
      "status": "dead",
      "attempts": 10,
      "http_status": 502,
      "error": "Bad Gateway",
      "duration_ms": 1840,
      "is_manual": false,
      "created_at": "2026-10-01T12:00:00Z",
      "delivered_at": null,
      "next_attempt_at": null
    }
  ]
}