Manejo de Errores

Cuando ocurre un error o una excepción en una solicitud a la API se retorna la información del error como se detalla a continuación:

Tipos de errores

La solicitud retornará un código (HTTP Status Code)

HTTP Status Code	HTTP Status Name	Description
400	Bad Request	Existe algún error en los parámetros enviados en la solicitud
403	Forbidden	Existe un error asociado al token enviado en la cabecera de la solicitud
404	Not Found	La URL solicitada no existe
405	Method Not Allowed	Método (GET/POST) incorrecto
500	Internal Server Error	Error interno del servidor

Ejemplo

A contiuación se muestra un ejemplo utilizado el método getDocument de la API de Duemint. En este ejemplo se a omitido deliberadamente el envío del parámetro :id que es requerido en la solicitud.

METHOD GET
curl "https://api.duemint.com/v1/getDocument?expandClient=1" \
 -H 'Authorization: Bearer <token>' -H 'Accept: application/json'

La respuesta a esta solicitud sería un Http status code 400 (Bad Request) con el siguiente contenido, en donde el valor error corresponde a un código de uso interno, y el valor message corresponde a una descripción detallada del error.

{"error":"010","message":"Param :id es requerido."}