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."}