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ón	Propósito
Resolver usuario por canal	Mapear WhatsApp/Telegram a un usuario.
Obtener user context	Fetch de profile, goals, nutrition y coaching context.
Registrar comida	Persistir comida estructurada interpretada por Agent.
Nutrition today	Responder progreso calórico del día.
Registrar workout	Persistir progreso de entrenamiento.
Registrar peso	Persistir logs de peso.

Idempotencia

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

Arquitectura

Seguridad y auth

APIs internas

APIs internas

Propósito

Auth

Operaciones principales

Idempotencia

​APIs internas

​Propósito

​Auth

​Operaciones principales

​Idempotencia

APIs internas

Propósito

Auth

Operaciones principales

Idempotencia