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

# API specs

> Mapa de alto nivel de las APIs de Platform y Agent.

# API specs

Las APIs de Moveat son APIs internas de producto. No están diseñadas hoy como superficie pública para terceros.

<Info>
  Los schemas exactos viven en Swagger de Platform. Esta página explica ownership y comportamiento a nivel alto.
</Info>

## Superficies

| Superficie            | Base                                  | Consumidor            | Auth                      | Propósito                       |
| --------------------- | ------------------------------------- | --------------------- | ------------------------- | ------------------------------- |
| Platform public API   | `https://api.mov-eat.app/v1`          | Web client            | Cookie HTTP-only          | Acciones de usuario.            |
| Platform internal API | `https://api.mov-eat.app/internal/v1` | Agent                 | Internal service token    | Operaciones service-to-service. |
| Platform health       | `https://api.mov-eat.app/healthz`     | Infra                 | Ninguna                   | Health checks.                  |
| Agent webhook/API     | `https://agent.mov-eat.app`           | Meta/WhatsApp e infra | Firma Meta / verify token | Webhooks y health.              |
| Swagger público       | `https://api.mov-eat.app/docs`        | Ingeniería            | Basic auth docs           | Inspección APIs públicas.       |
| Swagger Agent         | `https://api.mov-eat.app/agent-docs`  | Ingeniería            | Basic auth docs           | Inspección APIs internas.       |

## Platform public API

Soporta web flows: auth, `/me`, onboarding, channels, coaching, meals, weight y workouts.

Reglas:

* El user ID sale de la sesión, no del body.
* Platform hace conversiones de unidades.
* Las respuestas deben ser útiles para el consumidor que las renderiza.
* Los errores deben tener contexto y correlation IDs.

## Platform internal API para Agent

Permite que Agent delegue acciones sin tocar la DB.

Operaciones principales:

* Resolver usuario por canal.
* Obtener contexto de usuario.
* Registrar meal entry.
* Obtener nutrición de hoy.
* Registrar peso.
* Registrar workout.

## Agent API

Agent expone principalmente endpoints para webhooks y health.

## Estrategia OpenAPI

Siguiente mejora recomendada:

1. Mantener Swagger en Platform como contrato vivo.
2. Exportar OpenAPI público a `openapi/platform-public.json`.
3. Exportar OpenAPI interno a `openapi/platform-agent.json`.
4. Referenciar esos specs en `docs.json` para generar API Reference en Mintlify.