Códigos de error – Bancolombia Centro de Ayuda Desarrolladores

Si durante el consumo de API has obtenido una respuesta del servidor 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 más comunes que representan un error durante la petición a las API:

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	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. Para corregirlo, vuelve a generar el token con las credenciales y el scope o ambito respectivo los productos de APIs.
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 da 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 productos de depósitos válidos para el servicio de tus APIs.
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.