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