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

Тестовая отправка

POST/api/v1/vpn/webhook/test

Шлёт событие webhook.test на ваш адрес прямо сейчас и возвращает, что ответил сервер. Одна попытка, без ретраев.

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

Поля ответа

successboolean

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

deliveredboolean

Ваш сервер ответил 2xx.

statusstring

delivered при успехе, dead при неудаче: тестовая отправка не повторяется.

одно из:delivereddead

http_statusinteger | null

Что ответил ваш сервер; null, если не ответил.

errorstring | null

Почему доставка не удалась.

duration_msinteger

Сколько шла доставка, в миллисекундах.

delivery_iduuid

Запись в журнале «Доставки вебхуков», равна event_id события.

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

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

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

409webhook_not_configured: Адрес вебхука не задан

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

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

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

API-ключ

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

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

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

Запрос меняет данные или списывает деньги: выполняйте его из своего кода.

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

{
  "success": true,
  "delivered": true,
  "status": "delivered",
  "http_status": 200,
  "error": null,
  "duration_ms": 143,
  "delivery_id": "01a06321-0000-7000-8000-000000000001"
}