/api/v1/vpn/subscriptions/{subscription_id}/upgrade-quoteДоплата за переход: полная цена нового тарифа минус неиспользованный остаток текущего. Апгрейд перезапускает срок с текущего момента.
curl https://api.relayhub.surf/api/v1/vpn/subscriptions/<subscription_id>/upgrade-quote?new_plan_uuid=6ba7b810-9dad-11d1-80b4-00c04fd430c8 \
-H "Authorization: Bearer <YOUR_API_KEY>"{
"success": true,
"subscription_id": "01a06315-1270-705a-8d4c-58fea607bf2c",
"new_plan_uuid": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
"new_plan_name": "Pro 30d",
"remaining_days": 20,
"charge_minor": 300,
"charge_usd": "3.00"
}Заголовок Authorization: Bearer <ключ> на каждом запросе. Ключ один на аккаунт, выпускается в кабинете партнёра и показывается один раз. Он тратит депозит: держите его на сервере.
new_plan_uuidобязательноТариф из GET /plans.
successbooleanобязательноsubscription_idstringобязательноnew_plan_uuidstringобязательноnew_plan_namestringобязательноremaining_daysintegerобязательноcharge_minorintegerобязательноcharge_usdstringобязательно401unauthorized: Неверный или отсутствующий API-ключ403api_disabled: Доступ к API для этого аккаунта закрыт404subscription_not_found: Подписка не найдена; plan_not_found: Тариф не найден или недоступен409subscription_frozen: Подписка заморожена; subscription_expired: Подписка истекла; subscription_state: Операция не подходит к текущему состоянию подписки422Validation Error429rate_limited: Слишком много запросов503upstream_unavailable: Поставщик VPN временно недоступенcurl https://api.relayhub.surf/api/v1/vpn/subscriptions/<subscription_id>/upgrade-quote?new_plan_uuid=6ba7b810-9dad-11d1-80b4-00c04fd430c8 \
-H "Authorization: Bearer <YOUR_API_KEY>"{
"success": true,
"subscription_id": "01a06315-1270-705a-8d4c-58fea607bf2c",
"new_plan_uuid": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
"new_plan_name": "Pro 30d",
"remaining_days": 20,
"charge_minor": 300,
"charge_usd": "3.00"
}