Manejo de errores

Manejo de errores



Mensajes de error:

 

HTTP Status

errorCode

Descripción

HTTP Status

errorCode

Descripción

400 – BAD REQUEST

MISSING_FIELD

La petición no pudo ser procesada por falta un campo obligatorio.

INVALID_JSON_SYNTAX

La petición no pudo ser procesada porque el JSON presenta errores de sintaxis.

INVALID_DATA_TYPE

La petición no pudo ser procesada porque:

  • El tipo de dato es incorrecto.

  • Un valor de tipo ENUM es inexistente o inválido.

401 - UNAUTHORIZED

EXPIRED_TOKEN

El token enviado ha superado su tiempo de validez. Se requiere una nueva autenticación para obtener un token activo.

INVALID_TOKEN

El token enviado no es válido, está mal formado o no corresponde a una sesión activa.

403 - FORBIDDEN

PERMISSION_ERROR

El usuario tiene permiso insuficientes para ese recurso.

422 – UNPROCESSABLE ENTITY

VALIDATION_ERROR

El formato es correcto, pero la petición no cumple con las reglas de negocio (ej. el precio está fuera de banda, cantidad inválida, la cuenta no existe, etc.).

500 – INTERNAL SERVER ERROR

INTERNAL_ERROR

Error inesperado en el servidor.

 

Campos del body:

Field

Req.

Valid Values

Data Type

Description

Field

Req.

Valid Values

Data Type

Description

errorCode

N

 

String (Enum)

Código de error que identifica el tipo de falla. Puede ser utilizado por el cliente para manejo programático del error.

message

N

 

String

Descripción legible del error, destinada a facilitar el diagnóstico.

Ejemplo de body:

{ "errorCode": "MISSING_FIELD", "message": "Field 'quantity' is required" }