Что вызвать
Задача и нужный метод: от показа тарифов до белых списков и вебхуков.
- Показать тарифы и цены →
GET /plans - Узнать, хватит ли денег →
GET /balance - Пополнить депозит →
POST /deposit, статус вGET /deposit/{custom_id} - Выдать подписку на срок →
POST /subscriptionsсplan_uuidизplans - Выдать «Навсегда» →
POST /subscriptionsсplan_uuidиз блокаlifetime - Дать пробный период →
POST /subscriptions/trial - Посмотреть подписку и остаток трафика →
GET /subscriptions/{id} - Найти подписки пользователя →
GET /subscriptions?external_user_id=... - Найти человека из бота и его подписки →
GET /clients?telegram_id=... - Привязать людей из бота к своим id →
POST /clients/link, пачкойPOST /clients/link/batch - Узнать цену продления →
GET /subscriptions/{id}/renew-quote(сdaysдля N дней) - Продлить на период тарифа →
POST /subscriptions/{id}/renew - Продлить на любое число дней →
POST /subscriptions/{id}/renew-custom - Сменить тариф →
GET /subscriptions/{id}/upgrade-quote, затемPOST /subscriptions/{id}/upgrade - Купить белые списки (трафик) любой подписке →
POST /subscriptions/{id}/traffic - Добавить 15 устройств к «Навсегда» →
POST /subscriptions/{id}/addonsсdevices_15 - Не списать больше показанного →
max_charge_minorв теле любой платной операции - Узнать, чем кончилась операция →
GET /operations/{custom_id} - Заморозить и разморозить →
POST /subscriptions/{id}/freezeи/unfreeze - Выдать новую ссылку, если старая утекла →
POST /subscriptions/{id}/rotate-link - Посмотреть и отключить устройства (оба вида подписки) →
GET /subscriptions/{id}/devices,DELETE /subscriptions/{id}/devices/{device_id} - Проверить интеграцию без денег → тестовый ключ
sb_…из раздела «Песочница» - Узнать о продлении, окончании срока, трафике → вебхук:
PUT /webhook, проверкаPOST /webhook/test - Догнать события после сбоя вашего сервера →
GET /events?since=... - Посмотреть и повторить доставки вебхука →
GET /webhook/deliveries,POST /webhook/deliveries/{delivery_id}/redeliver - Синхронизировать свою базу подписок →
GET /subscriptions?updated_since=...