Los códigos de estado HTTP con los que responde la API, y qué significa recibir cada uno.
Aquí encontrarás los códigos de estado con los que la API de Toku responde cada llamada, y qué significa recibir cada uno.
Las respuestas usan la convención de códigos de estado HTTP para indicar si la llamada fue exitosa o falló: un 2xx es éxito, un 4xx señala un problema en la petición (datos, autenticación, permisos) y un 5xx, un problema de Toku.
| Status | Significado | Cuándo lo recibes |
|---|---|---|
200 | OK | La llamada fue exitosa. |
201 | Created | La llamada fue exitosa y creó uno o más objetos. |
202 | Accepted | La solicitud fue aceptada y se procesa de forma asíncrona. |
204 | No Content | La llamada fue exitosa y no hay cuerpo que devolver. |
400 | Bad Request | La petición está mal formada o sus datos no son utilizables. |
401 | Unauthorized | Falta la credencial en el header, o su formato es incorrecto. |
403 | Forbidden | La credencial es válida, pero no tiene permisos para esta operación. |
404 | Not Found | El recurso no existe, o no es visible para tu organización. |
409 | Conflict | La operación choca con el estado actual del recurso. |
422 | Unprocessable Entity | La petición está bien formada pero no pasa la validación. |
429 | Too Many Requests | Superaste el límite de llamadas del endpoint. Ver Límites de tasa. |
5xx | Server Error | El problema es de Toku, no de tu petición. |
Cada endpoint declara los códigos que puede retornar en su propia página, en la categoría Recursos.
El status es sólo el primer nivel de información: el cuerpo de la respuesta trae además un código interno TKxxxxx que identifica el error exacto. Su forma está en Errores y códigos de respuesta y el listado completo, en Códigos de API.