Saltar al contenido principal

Manejo de errores

Al interactuar con los diferentes endpoints de la API, pueden ocurrir una serie de errores dependiendo de diferentes situaciones como enviar datos en formato incorrecto, parámetros inválidos, etc.

En Cincel manejamos un estándar propio para las posibles respuestas de todos los endpoints. Dicha respuesta está conformada por 3 variables principales: ok, payload y errors.

Si la llamada se realizó de manera exitosa la variable ok tendrá un valor de true y dentro de payload encontrarás el contenido esperado por la llamada realizada, la cuál se especifica en cada una de las llamadas.

Respuesta exitosa:

{    "ok": true,    "payload": {      ...    }}

Por el contrario si ocurré un problema, la variable ok tendrá un valor de false y errors contendrá información sobre el error o errores detectados.

El formato de los errores está definido de la siguiente manera:

{    "ok": false,    "errors":{      "variable_1": ["error 1","error n"],      "arreglo_1": {        "index_elemento": {          "variable_1_elemento_1":["error 1","error n"]        }      }    }
}

Tanto las respuestas exitosas como los errores conocidos, regresarán un status 200, en caso de que ocurra un error inesperado (lo cuál es raro), se regresará un status 500.