Errores comunes
Esta información te permitirá gestionar algunos desafíos que puedes presentar al consumir nuestras APIs
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 APIs Bancolombia.
|
Si al consumir la API Authorization, no se pueden comprobar o no son funcionales las credenciales productivas, haz lo siguiente:
- Asegura que la API Authorization se encuentra suscrita.
- Verifica que estés usando un scope (ámbito) correcto. Te invitamos a ver el artículo ¿Dónde verifico el scope o ámbito de las APIs?
- Verifica que estas usando la URL correcta para la generación del token que te permite acceder a la API Authorization.
Si continua el error, escríbenos a través del chat o del formulario. Si lo necesitas puedes consultar ¿Cómo creo una solicitud?
En el proceso de vinculación del monedero digital, para poder consumir las APIs de aceptar los términos y condiciones, validar el OTP, listar productos de depósitos y seleccionar la cuenta a vincular en la lista de productos de depósitos, se cuenta con 60 minutos una vez genera el token, de lo contrario ninguna de las APIs podrá realizar sus operaciones respectivas.
¿Se te han presentado errores cómo EFA001, EFA002 ó EFA003?. Estos errores, también conocidos como EFAXX, tienen que ver con problemas para autenticar a tu cliente, pero antes de ir hasta ese punto recordemos que es el FUA:
FUA - Formulario Único de Autenticación: es un componente que provee el banco para que el consumidor lo incluya en sus aplicaciones o páginas. Este permite realizar el proceso de autenticación de un cliente Bancolombia por medio de su usuario y clave y así, poder cumplir con un primer factor de autenticación.
Los errores EFAXX se presentan cuando el FUA no reconoce los datos de acceso de tu cliente y, por lo tanto, impide la generación del token, que a su vez, limita la experiencia extraordinaria que se le quiere ofrecer al usuario.
A continuación te presentamos la descripción y causa de cada uno de estos errores:
- EFA001: Este se muestra cuando se digita la URL invalida y el canal solicitado es IFD.
- EFA002: Esta transacción ha expirado (timeout). Este se da cuando durante 3 minutos no ha habido actividad en el Formulario User y Pass.
- EFA003: Acceso Bloqueado - Inténtalo nuevamente en 24 horas. Se genera cuando falla 3 veces la autenticación.