Códigos de error – Centro de Ayuda APIs Bancolombia

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: La APP creada en el API Market esté suscripta al producto de APIs correcto. Las credenciales (client id y client secret) utilizadas para consumir el API de autorización (API utilizada para generar el token) correspondan a las generadas para la APP el scope o ambito sea el respectivo a los productos de APIs que estas consumiendo.
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.