Conceptos

Errores

Todos los errores devuelven un cuerpo JSON con esta estructura:

Code(json)
 
{
  "status": 400,
  "message": "Descripción legible del problema",
  "errors": null
}

Campos

Campo	Tipo	Descripción
`status`	`number`	Código HTTP, igual al status de la respuesta.
`message`	`string`	Mensaje descriptivo del error.
`errors`	`object \| null`	En errores de validación (400), un mapa de `campo → [mensajes]`. En el resto de errores es `null`.

Ejemplo: error de validación

Code(json)
 
{
  "status": 400,
  "message": "Uno o más errores de validación ocurrieron.",
  "errors": {
    "page": ["El valor debe ser mayor o igual a 1."],
    "limit": ["El valor debe estar entre 1 y 500."]
  }
}

Códigos HTTP comunes

Código	Significado	Causa típica
200	OK	Éxito
400	Bad Request	Parámetros inválidos (ej: `page` no numérico)
401	Unauthorized	API key ausente o inválida
403	Forbidden	API key válida pero no autorizada para esta license key
404	Not Found	License key no existe o no pertenece a tu cuenta
408	Request Timeout	La consulta tardó demasiado en la sucursal
429	Too Many Requests	Excedido el límite de tasa
503	Service Unavailable	La sucursal está fuera de línea
500	Internal Server Error	Algo falló en nuestro lado. Reintenta con back-off.

Cómo reportar un error

Si encuentras un comportamiento que parece un bug:

Anota la fecha/hora exacta y el endpoint llamado.
Captura el cuerpo de la respuesta completa.
Escribe a soporte@wrestaurantapi.com con esa información.

Límites

Conceptos

Errores

Todos los errores devuelven un cuerpo JSON con esta estructura:

Code(json)
 
{
  "status": 400,
  "message": "Descripción legible del problema",
  "errors": null
}

Campos

Campo	Tipo	Descripción
`status`	`number`	Código HTTP, igual al status de la respuesta.
`message`	`string`	Mensaje descriptivo del error.
`errors`	`object \| null`	En errores de validación (400), un mapa de `campo → [mensajes]`. En el resto de errores es `null`.

Ejemplo: error de validación

Code(json)
 
{
  "status": 400,
  "message": "Uno o más errores de validación ocurrieron.",
  "errors": {
    "page": ["El valor debe ser mayor o igual a 1."],
    "limit": ["El valor debe estar entre 1 y 500."]
  }
}

Códigos HTTP comunes

Código	Significado	Causa típica
200	OK	Éxito
400	Bad Request	Parámetros inválidos (ej: `page` no numérico)
401	Unauthorized	API key ausente o inválida
403	Forbidden	API key válida pero no autorizada para esta license key
404	Not Found	License key no existe o no pertenece a tu cuenta
408	Request Timeout	La consulta tardó demasiado en la sucursal
429	Too Many Requests	Excedido el límite de tasa
503	Service Unavailable	La sucursal está fuera de línea
500	Internal Server Error	Algo falló en nuestro lado. Reintenta con back-off.

Cómo reportar un error

Si encuentras un comportamiento que parece un bug:

Anota la fecha/hora exacta y el endpoint llamado.
Captura el cuerpo de la respuesta completa.
Escribe a soporte@wrestaurantapi.com con esa información.

Límites