Saltar al contenido principal

APIs internas

Las APIs internas son endpoints service-to-service para Agent, no para frontend.

Propósito

Agent recibe lenguaje natural y eventos de canales. Platform ejecuta y persiste la acción de negocio.

Auth

Requieren la variable de entorno del token interno configurada en Platform y Agent/infra. Si falta o es incorrecto, Agent debe fallar de forma explícita.

Operaciones principales

OperaciónPropósito
Resolver usuario por canalMapear WhatsApp/Telegram a un usuario.
Obtener user contextFetch de profile, goals, nutrition y coaching context.
Registrar comidaPersistir comida estructurada interpretada por Agent.
Nutrition todayResponder progreso calórico del día.
Registrar workoutPersistir progreso de entrenamiento.
Registrar pesoPersistir logs de peso.

Idempotencia

Writes desde Agent deben incluir idempotency key basada en el message ID del canal.