> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alvys.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Códigos de respuesta

> Códigos de estado HTTP devueltos por Alvys Public API — éxito 2XX, errores de cliente 4XX y errores de servidor 5XX — con descripciones de cada código de error.

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](/docs/rate-limits) 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). |