Overview de APIs

Las APIs de Moveat no están pensadas hoy como integración pública para terceros. Existen para soportar la web app y Agent.

Categorías

Categoría	Prefix	Consumidor	Propósito
APIs públicas	`/v1`	Web app	Acciones de usuario.
APIs internas	`/internal/v1`	Agent	Operaciones service-to-service.
Health	`/healthz`	Infra	Checks de uptime.
Swagger	`/docs`, `/agent-docs`	Ingeniería	Inspección de contratos.

APIs públicas

Soportan auth, /me, onboarding, profile/context, channels, meals, weight y workouts. Autentican con sesión web.

APIs internas

Soportan resolver usuario por canal, obtener contexto, registrar comidas, obtener resumen nutricional diario, registrar workouts y peso. Autentican con internal service token.

Modelo de errores

Status	Significado
400	Payload inválido.
401	Sesión/token faltante o inválido.
403	No permitido.
404	Recurso no encontrado.
409	Conflicto o estado incompleto.
429	Rate limited.
500	Error inesperado.

Swagger explica shapes exactos; esta documentación explica flujos y decisiones.