> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mov-eat.app/llms.txt
> Use this file to discover all available pages before exploring further.

# APIs internas

> Cómo Agent debe usar las APIs internas de Platform.

# 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.