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

Отправить событие заново

POST/api/v1/vpn/webhook/deliveries/{delivery_id}/redeliver

Повторяет доставку прямо сейчас тем же телом (новая метка времени и подпись) и возвращает, что ответил ваш сервер. Одна попытка, счётчик неудач адреса не растёт. Не больше 10 ручных отправок в минуту вместе с тестовой.

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

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

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

Доставка: delivery_id из GET /webhook/deliveries или event_id из ленты событий.

Поля ответа

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: Адрес запроса не входит в список разрешённых

404not_found: Объект не найден

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

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

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

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

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

API-ключ

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

delivery_id*

curl -X POST https://api.relayhub.surf/api/v1/vpn/webhook/deliveries/<delivery_id>/redeliver \
  -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"
}