Manejo de Errores

Formato actual de respuesta de error

La API actual usa un envelope de error con campos top-level:

{
  "success": false,
  "message": "validation.invalid_data",
  "error": "Bad Request",
  "statusCode": 400,
  "timestamp": "2026-03-10T18:00:00.000Z",
  "path": "/api/partner/reservations",
  "errors": {
    "messages": ["guestEmail.validation.invalid_email"]
  },
  "requestId": "req_123"
}

Notas

• message va a nivel superior
• error va a nivel superior
• statusCode va a nivel superior
• los detalles de validación, cuando existen, viven en errors
• errores 429 pueden incluir retryAfter

Estados típicos

• 400 input inválido
• 401 auth faltante/inválida
• 403 forbidden
• 404 recurso no encontrado
• 409 conflicto
• 422 fallo de regla de negocio
• 429 límite de tasa excedido
• 500 error interno