API Administrador
Documentación oficial de la API central y de administración. Permite aprovisionar empresas, consultar planes, controlar revendedores, enviar notificaciones WhatsApp y buscar comprobantes públicos.
Versión 1.0.0.
Servidor
La base URL es el host del panel administrador (system), por ejemplo https://pro.uio.la. Todas las rutas de esta referencia se resuelven contra ese origen.
| Entorno | URL |
|---|---|
| Servidor central | https://{tu-dominio} |
Los ejemplos de esta guía usan rutas relativas (/api/login, /api/tenants, …). Sustituye el host por el de tu instalación.
Autenticación
Hay dos esquemas HTTP Bearer. El token se envía en el encabezado:
Authorization: Bearer <token>
SystemBearerAuth
Token de acceso personal generado en POST /api/login. Úsalo en los endpoints de tenants, planes, revendedores, auto-registro, partners y métricas.
| Campo | Valor |
|---|---|
| Tipo | HTTP Bearer |
| Formato | Token |
Token de administrador
El api_token lo emite el login del usuario administrador del sistema central. No es el token de un usuario de tenant.
WhatsAppBearerAuth
Token de notificación configurado en el superadministrador (notify_wa_api_token). Solo aplica a /api/whatsapp-notify/*.
| Campo | Valor |
|---|---|
| Tipo | HTTP Bearer |
| Formato | Token |
Token distinto
WhatsApp no usa el token de POST /api/login. Si envías el Bearer de administrador a /api/whatsapp-notify/* recibirás 401.
Endpoints públicos
Estos métodos no requieren autenticación:
Qué puedes hacer
- Gestionar el aprovisionamiento de empresas (
/api/tenants). - Consultar planes, cuotas y suscripciones (
/api/plans). - Bloquear tenants de forma global o individual (
/api/reseller/*). - Enviar texto, multimedia y PDF por WhatsApp (
/api/whatsapp-notify/*). - Registrar partners de restaurantes y consultar comprobantes públicos.
Clientes generados
Cada sección de esta API está vinculada al método equivalente del cliente. El código vive en sdks/ y se regenera con bash scripts/generate-api-sdks.sh.