Febos tiene 2 tipos de respuestas, por un lado estan las respuestas a nivel de aplicación, es decir aquellas que son producidos por en las entrañas de Febos, ya sean una respuesta de error o un mensaje de acción realizada satisfactoriamente. Por otro lado, estan los errores que son producidos por la tecnología que utiliza Febos, estos mensajes son en ingles y ocurren en casos muy particulares, siendo 2 mensajes los que más se repiten y se explican mas abajo.4.1. Campos estandar#
Todas las respuestas de Febos, incluso aquellas que corresponden a un error, son retornadas con el codigo HTTP 200, es decir, a nivel de procolo web, indican una respuesta "correcta" (incluso siendo un error). Esto se debe a que en la búsqueda de la compatibilidad con sistemas externos, los cuales deben integrarse con Febos, se encuentran sistemas tanto antiguos como modernos, y en ocasiones puede ser complejo administrar los distintos códigos HTTP que el protocolo provee (como el famoso código 404 cuando algo no es encontrado). En reemplazo, Febos provee un código de respuesta en TODAS sus respuestas, siendo el código 10 un código de error satisfactorio (es decir la acción solicitada se llevo a cabo de forma exitosa), y cualquier otro código numérico significa que se ha producido un error. Los códigos numéricos de error menos a 10 estan relacionados con autenticación y autotización, mientras que los códigos de error superiores al código 10, son errores de lógicas de negocio, configuración o errores más complejos. Cada respuesta de Febos contará con 2 campos fijos, más un tercer campo opcional:codigo: (int) Este campo representa el código del resultado de la ejecución de la API, tal como se explica más arriba, 10 es una respuesta satisfactoria, mientras que cualquier otro código es error.
mensaje: (string) Traducción humana del código anterior.
errores: (arreglo de string) Contiene los distintos errores que se estan produciendo, o el detalle del error que se produjo.
seguimientoId: (string) Código único de solicitud, cada respuesta contiene un código único que identifica la llamada, con este identificador nuestro equipo puede ver los logs relacionados al proceso para ayudar en caso de ser necesario. Es altamente recomendable almacenar este identificador (o registrarlo en los logs de su integración).
duracion: (int) Tiempo en milisegundos que tardo en procesarse la solicitud. Este número no toma en cuenta el tiempo que tardó en enviarse la solicitud ni recibirse la respuesta (es decir tiempos de comunicación), si no que solo tiempos de proceso.
4.2. Respuestas fuera de nuestro control#
Debido a que Febos opera sobre Amazon, existen algunos errores que no podemos controlar, los cuales escapan a la lógica de los mensajes estandar de Febos. Éstos errores estan muy bien identificados, y especifican a continuación:4.2.1. Timeout#
Nunca una respuesta de la API de Febos demorará más de 30 segundos en responder, en un caso en que la el proceso detrás de la API tarde mas de 30 segundos, el error retornado tendrá una estructura similar a la estándar, solo que con menos campos, y el campo ´codigo´ representa el código de error HTTP (400,404,500, etc):codigo: (int) Este campo representa el código del resultado de la ejecución de la API, tal como se explica más arriba, 10 es una respuesta satisfactoria, mientras que cualquier otro código es error.
mensaje: (string) Traducción humana del código anterior.
errores: (arreglo de string) contiene el error que retorna AWS
4.2.2. Endpoint no existe#
Si te confundes por alguna razón, o existe un error en tu aplicación, podrias recibir el error descrito más abajo, el cual indica que el Endpoint que estas consumiento no existe. Es decir estas invocando una URL incorrecta, o el VERBO (get, post, put, etc) utilizado no se corresponde con esa URL, el error retornado tendrá una estructura similar a la estándar, solo que con menos campos, y el campo ´codigo´ representa el código de error HTTP (400,404,500, etc):codigo: (int) Este campo representa el código del resultado de la ejecución de la API, tal como se explica más arriba, 10 es una respuesta satisfactoria, mientras que cualquier otro código es error.
mensaje: (string) Traducción humana del código anterior.
errores: (arreglo de string) contiene el error que retorna AWS
Modificado en 2025-09-16 19:42:26
