Pipeline de API: hacer Pro un proyecto
Objetivo: hacer Pro un proyecto con tu saldo (mes a mes) o con un hueco de tu plan Pro; ampliarlo, desactivar la renovación automática o terminarlo ya.
Pro es lo que hace funcionar las campañas: una campaña solo arranca en un proyecto con Pro activo (un proyecto nuevo puede recibir un radar inicial gratuito de 7 días: Pipeline de API: recibir un radar inicial gratuito de 7 días para tu proyecto y seguir sus coincidencias), y los oráculos de cuentas de Telegram necesitan un proyecto Pro.
Pasos
1. Precio y plan. GET /v0/my/plan → "project_usd": "18.00", y si hay un plan activo con huecos libres (active, projects, slots). Un hueco libre del plan se usa en lugar de pagar: Pipeline de API: comprar un plan Pro para hasta 10 proyectos
2. Saldo. GET /v0/my/funds/check-balance → {"balance": "31.00", …}.
3. Precio con cupón (opcional). 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, …}. Cupones: Pipeline de API: canjear un cupón
4. Activar.
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. Ampliar. La misma llamada mientras el proyecto es Pro añade un mes tras la fecha de fin actual.
6. Desactivar la renovación automática. DELETE /v0/my/projects/<project>/pro → "auto_renew": false; Pro sigue hasta pro_until.
7. Terminar ya. POST /v0/my/projects/<project>/pro/deactivate → "membership": "Free"; las campañas y los oráculos del proyecto se detienen al instante; el mes pagado no se reembolsa.
Detrás
- Renovación: el mismo día del mes siguiente, 18 USDT del saldo, mientras
auto_renewesté activo. - Saldo insuficiente al renovar: el proyecto pasa a Free, sus campañas y oráculos se detienen y @CabiChatBot te avisa. Recarga y vuelve a activarlo.
Reglas
- Saldo insuficiente → 400
insufficient funds: 18 USDT required for Pro membership. - Tu plan tiene un hueco libre → 400
your plan has a free slot — use it for this project. - En un hueco del plan: activar → 400
project is on a plan slot; desactivar → 400project is on a plan slot — release the slot instead. - Solo tus propios proyectos → si no, 404.
Superficie de la API
| Endpoint | Para qué | FE | IA / oráculo |
|---|---|---|---|
GET /v0/my/plan |
Precio, huecos del plan | sí | sí |
GET /v0/my/coupons/quote |
Precio con un cupón | sí | sí |
POST /v0/my/projects/{nonce}/pro |
Activar o ampliar | sí | sí |
DELETE /v0/my/projects/{nonce}/pro |
Desactivar la renovación automática | sí | sí |
POST /v0/my/projects/{nonce}/pro/deactivate |
Terminar ya | no | sí |
POST/DELETE /v0/my/plan/projects/{nonce} |
Usar / liberar un hueco del plan | sí | sí |
Índice: Pipelines de API — índice