Errores de la API

Formato consistente para entender y manejar errores.

Formato de error

Todos los errores devuelven JSON con código, mensaje y detalles opcionales.

response.json
1
2
3
4
5
6
{
  "error": {
    "code": "not_found",
    "message": "Producto no encontrado"
  }
}

unauthorized

Token inválido o ausente.

forbidden

No tienes permisos para esta acción.

not_found

El recurso no existe.

validation_error

Los datos enviados no son válidos.