BRAIN AWAKE — Cerebro API

Despierta tu mente. Activa tu día. Backend central multi-proveedor para Flutter y paneles administrativos.

v1.0.0PHP 8.3MariaDBJWT

Descargar OpenAPI JSON · Estado del servicio · Panel administrativo

Base URL

https://brainawake.suvcrea.com/api/v1

Autenticación

Authorization: Bearer <access_token>

Formato

application/json

Panel admin

/admin/

1. Flujo para Flutter

POST /api/v1/auth/login        -> access_token + refresh_token
GET  /api/v1/auth/me           -> usuario + suscripción + proveedores
POST /api/v1/providers/link    -> vincula Portal Éxitus y sincroniza
GET  /api/v1/data/tasks        -> tareas normalizadas
GET  /api/v1/data/alarms       -> alarmas normalizadas
GET  /api/v1/data/agenda       -> agenda / planificador
POST /api/v1/auth/refresh      -> rota el refresh token

La app nunca debe consumir Portal Éxitus directamente. El Cerebro cifra los tokens del proveedor y normaliza la respuesta.

2. Endpoints

MétodoRutaDescripción
POST/auth/registerRegistro central + prueba gratuita
POST/auth/loginLogin central
POST/auth/refreshRenovar tokens
POST/auth/logoutCerrar sesión
GET/auth/mePerfil, suscripción y vínculos
GET/providersProveedores disponibles
POST/providers/linkVincular proveedor externo
POST/providers/sync/{id}Sincronizar proveedor
GET/plansPlanes Free/Premium
GET/subscriptions/meSuscripción activa
POST/subscriptions/subscribeAdquirir plan
GET/data/scheduleHorario normalizado
GET/data/tasksTareas normalizadas
GET/data/alarmsAlarmas normalizadas
GET/data/planningPlanificación del proveedor
POST/data/syncSincronización completa
GET/admin/stats/overviewKPIs globales
GET/POST/PUT/DELETE/admin/providersGestión de proveedores
GET/POST/PUT/DELETE/admin/plansGestión de planes
GET/POST/PUT/admin/usersGestión de usuarios
GET/POST/admin/subscriptionsGestión de suscripciones
GET/admin/auditAuditoría

3. Multiplataforma y multi-proveedor

Flutter

Consume el Cerebro como única fuente. Guarda access/refresh tokens y refresca ante 401.

Panel web

Ingresa en /admin/ con un usuario es_admin=true. El panel consume la misma API /admin/*.

Nuevos proveedores

Se registran en la tabla providers y un adaptador implementa el contrato de sincronización.

4. Planes

Free Alarma interactiva, desafíos, recordatorios y horario.

Premium Explicaciones, recordatorios ilimitados, concentración, simulacros UNP y prácticas.

Precios: mensual S/ 9.90 · semestral S/ 53.50 · anual S/ 99.00.

5. Códigos de error

HTTPcodeSignificado
401unauthorizedToken ausente, inválido o expirado
403forbiddenUsuario no administrador
404not_foundRecurso inexistente
422validation_errorDatos incompletos o inválidos
429rate_limitedLímite de solicitudes excedido
502provider_errorFallo al consumir el proveedor externo