Si durante el consumo de API has obtenido una respuesta que no era la que esperabas, los códigos de respuesta HTTP pueden ser tus mejores aliados para descubrir posibles fallas, inconsistencias o errores ya sea en la petición realizada por el consumidor o la respuesta ofrecida por la API.
El propósito de estos códigos es informar al usuario el estado de la solicitud realizada al servidor. Existen diferentes tipos de códigos HTTP, algunos pueden ser de carácter meramente informativo, otros llegan a notificar sobre respuestas exitosas o redireccionamientos, e incluso, hay algunos códigos que nos confirman la existencia de un error.
Te compartimos a continuación una lista de los códigos y de las causas más comunes de error; sin embargo, te sugerimos que primero consultes la firma o el contrato de la API, este contiene el código y descripción especifico para la capacidad que estas consumiendo:
| Código HTTP | Causa de respuesta |
| 400 |
Este error se da porque no se está enviando la petición correctamente acorde a la firma de la API. Valida el correcto envío de los campos de las APIs, puede que haya un campo requerido, vacío o con un valor que no corresponde.
|
| 401 |
Uno de los motivos principales de este error es que no se tienen autorización. El token que genera el API Authorization tiene tiempo limitado, en caso de usarlo después de dicho tiempo o ingresarlo de forma errada, te genera este error 401. Otro motivo puede darse por error en las credenciales (client id y client secret)
Para superar este error te sugerimos, validar que:
|
| 403 |
Valida que estés usando el scope o ámbito correcto en la generación del token con la API Authentication. Te puede interesar el artículo ¿Dónde verifico el scope o ámbito de las APIs?
|
| 404 |
Este error se puede dar porque el recurso solicitado no existe. Revisa que los datos enviados en la petición correspondan con un recurso existente, por ejemplo, puede que tu usuario sea cliente del banco, pero no tiene un producto válido para esa API. Otro error frecuente es que el endpoint este errado al realizar la petición, tal vez por un error de digitación o puede ser un problema con la suscripción de la APP en el API Market. También se puede generar por incidentes temporales con relación a los DNS o temas de firewall a nivel del banco, el consumidor o el proveedor de internet, pero suelen ser incidentes más transversales ajenos al API.
|
| 405 |
Revisa la documentación de tus APIs, estás realizando la petición con una operación o método http no permitida.
|
| 408 |
Inténtalo de nuevo, puede haber alguna intermitencia.
|
| 409 |
Existe algún conflicto con los datos enviados en la petición. Verifica los datos enviados en la petición.
|
| 415 |
Valida el correcto envío de la carga, puede que haya datos como el header errados.
|
| 431 |
Valida el correcto envío de la carga, puede que haya datos como el header errados.
|
| 500 |
Indica que la solicitud fue aceptada, pero que el servidor tiene un error que le impide devolver la respuesta. En este caso contáctanos desde el Centro de Ayuda APIs Bancolombia.
|
Comentarios
0 comentarios
Inicie sesión para dejar un comentario.