API-пайплайн: подключить Pro для проекта

Цель: подключить Pro для проекта с баланса (по месяцу) или через слот вашего плана Pro; продлить, отключить автопродление или завершить сразу.

Pro — это то, на чём работают кампании: кампания запускается только на проекте с активным Pro (новый проект может получить один бесплатный 7-дневный стартовый радар: API-пайплайн: получить бесплатный 7-дневный стартовый радар для своего проекта и смотреть его совпадения), а оракулам на аккаунтах Telegram нужен проект с Pro.

Шаги

1. Цена и план. GET /v0/my/plan → "project_usd": "18.00" и есть ли активный план со свободными слотами (active, projects, slots). Свободный слот плана используется вместо оплаты: API-пайплайн: купить план Pro до 10 проектов

2. Баланс. GET /v0/my/funds/check-balance → {"balance": "31.00", …}.

3. Цена с купоном (по желанию). GET /v0/my/coupons/quote?coupon=<clip>&target=pro&project=<project> → {"list_usd": 18.0, "discount_usd": 9.0, "charged_usd": 9.0, "enough": true, …}. Купоны: API-пайплайн: применить купон

4. Подключение.

POST /v0/my/projects/<project>/pro
{}                          (or {"coupon": "<clip>"})
→ {"nonce": "<project>", "membership": "Pro", "pro_until": "2026-11-15T10:00:00Z", "auto_renew": true, …,
   "list_usd": 18.0, "discount_usd": 0.0, "charged_usd": 18.0}

5. Продление. Тот же вызов, пока Pro активен, добавляет месяц после текущей даты окончания.

6. Отключить автопродление. DELETE /v0/my/projects/<project>/pro → "auto_renew": false; Pro действует до pro_until.

7. Завершить сразу. POST /v0/my/projects/<project>/pro/deactivate → "membership": "Free"; кампании и оракулы проекта сразу останавливаются; оплаченный месяц не возвращается.

Что происходит за кадром

• Продление: в тот же день следующего месяца, 18 USDT с баланса, пока включён auto_renew.
• Не хватает баланса при продлении: проект становится Free, его кампании и оракулы останавливаются, и @CabiChatBot сообщает вам об этом. Пополните баланс и подключите снова.

Правила

• Недостаточно средств → 400 insufficient funds: 18 USDT required for Pro membership.
• В вашем плане есть свободный слот → 400 your plan has a free slot — use it for this project.
• На слоте плана: подключение → 400 project is on a plan slot; отключение → 400 project is on a plan slot — release the slot instead.
• Только ваши собственные проекты → иначе 404.

Поверхность API

Индекс: API-пайплайны — индекс