Códigos de respuesta

Todas las solicitudes de API responderán con un código de estado HTTP apropiado. Su cliente de API debería manejar cada clase de respuesta de manera diferente:

2XX Respuestas exitosas
4XX Las respuestas de error del cliente indican un problema con la solicitud, como parámetros faltantes o un valor no válido. Modifique la solicitud antes de volver a intentarlo.
5XX Las respuestas de error del servidor indican un problema temporal en el lado de Alvys. Vuelva a intentar la solicitud después de un tiempo. Si los problemas persisten, comuníquese con el soporte para obtener más ayuda.

Códigos de error

Alvys utiliza códigos de respuesta HTTP convencionales para indicar el éxito o el fracaso de una solicitud de API. A continuación se muestra una tabla de códigos de error para ayudarle a depurar. El cuerpo de la respuesta de error puede incluir un mensaje de error, pero evite codificar mensajes específicos, ya que Alvys se reserva el derecho de cambiar el mensaje de error sin incrementar automáticamente la versión de API. Utilice mensajes de error únicamente con fines de depuración.

Código de estado	Descripción
400	Solicitud incorrecta - Error general del cliente, posiblemente datos con formato incorrecto. Los mensajes de error comunes incluyen: “Configuration limit exceeded” (por ejemplo, límites del sistema para crear más objetos como usuarios, conductores y documentos). Comuníquese con Soporte para solicitar aumentos.
401	Sin autenticar - El token de acceso falta o no es válido. Una ruta mal escrita o desconocida no produce 401.
403	Permiso denegado - No tiene acceso al recurso solicitado.
404	No encontrado - La ruta de la solicitud no coincide con un punto final publicado, o un parámetro de ruta no coincide con un recurso (por ejemplo, `id` en `/drivers/\{id}`).
405	Método no permitido - El punto final de API no acepta ese método HTTP.
415	Tipo de medio no admitido - El `Content-Type` de la solicitud no es compatible con este punto final. Solo se aceptan `application/json` y `application/x-www-form-urlencoded`.
429	Demasiadas solicitudes - El cliente ha alcanzado o superado un límite de velocidad, un límite de uso o el servidor está sobrecargado. Consulte Límites de solicitudes para obtener sugerencias sobre patrones de reintento.
5XX	Errores internos del servidor - algo salió mal con los servidores de Alvys. Es probable que estas respuestas sean errores momentáneos (por ejemplo, indisponibilidad temporal) y, como resultado, las solicitudes deben volver a intentarse mediante un retroceso exponencial. Tenga en cuenta que el cuerpo de estas respuestas sigue el formato `application/problem+json` (ProblemDetails).

​Códigos de error

Códigos de error