API specs
Las APIs de Moveat son APIs internas de producto. No están diseñadas hoy como superficie pública para terceros.Los schemas exactos viven en Swagger de Platform. Esta página explica ownership y comportamiento a nivel alto.
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:- Mantener Swagger en Platform como contrato vivo.
- Exportar OpenAPI público a
openapi/platform-public.json. - Exportar OpenAPI interno a
openapi/platform-agent.json. - Referenciar esos specs en
docs.jsonpara generar API Reference en Mintlify.