Referencia de Endpoints de la API
Referencia de Endpoints de la API
Sección titulada «Referencia de Endpoints de la API»Todos los endpoints están montados bajo el prefijo /api en el servidor Hono (apps/api/src/index.ts).
Resumen de Rutas Principales
Sección titulada «Resumen de Rutas Principales»| Prefijo de Ruta | Descripción | Autenticación / Rol Requerido |
|---|---|---|
/api/health |
Estado del servicio backend | Pública |
/api/auth/* |
Endpoints de Better Auth (login, logout, session) | Pública / Privada |
/api/public/* |
Menú público, estado de lista de espera | Pública |
/api/cron/* |
Ejecución de tareas programadas (trigger interno) | Token Cron |
/api/ingredients |
Catálogo e inventario de ingredientes | Sesión activa (requireRole) |
/api/suppliers |
Gestión de proveedores | Sesión activa |
/api/supplier-prices |
Listas de precios por proveedor | Sesión activa |
/api/customers |
Directorio de clientes | Sesión activa |
/api/org-settings |
Configuración del restaurante | owner / admin |
/api/branches |
Gestión de sucursales físicas de la organización | owner / admin |
/api/menus |
Menús, categorías y overrides por sucursal (GET/PUT /overrides) |
Sesión activa |
/api/modifiers |
Grupos de modificadores (ej. término de carne) | Sesión activa |
/api/purchase-orders |
Órdenes de compra e insumos | Sesión activa |
/api/tables |
Mapa de mesas y salones | Sesión activa |
/api/stations |
Estaciones de preparación (cocina/barra) | Sesión activa |
/api/payment-methods |
Formas de pago configuradas | Sesión activa |
/api/pos/orders |
Apertura, edición, envío y cobro de órdenes POS | Sesión activa (requireFloorRole) |
/api/pos/print-jobs |
Cola de impresión de tickets | Sesión activa |
/api/cash-sessions |
Apertura, consulta y cierre de caja | owner / admin |
/api/reservations |
Reservas de mesas | Sesión activa |
/api/staff-roles |
Roles de personal con scope de sucursal y estación | owner / admin |
/api/staff-shifts |
Control de turnos y asistencias | Sesión activa |
/api/kds |
Pantalla de cocina (KDS) y cambio de estado | Sesión activa |
/api/waitlist |
Lista de espera de clientes en entrada | Sesión activa |
/api/approvals |
Resoluciones de aprobaciones HITL | Sesión activa |
/api/agent-activity |
Historial de auditoría de agentes IA | Sesión activa |
/api/ai-usage |
Consumo de IA en neuronas (GET /, GET /events, PUT /quota) |
Sesión activa; PUT /quota solo owner / admin |
/api/reports |
Reportes de ventas, costos y métricas | Sesión activa |
/api/chat |
Asistente virtual de Inteligencia Artificial | Sesión activa |