Límites de solicitudes

Alvys Las API emplean límites de solicitudes para garantizar un uso justo y proteger nuestra infraestructura de solicitudes excesivas, evitando posibles abusos y manteniendo un rendimiento constante. Este documento describe los límites de solicitudes globales y específicos de endpoints aplicados al uso de API. Si excede cualquiera de los límites de solicitudes que se describen a continuación, Alvys responderá con un código de error 429.

Cambios ad hoc en el límite de solicitudessNota: Alvys se reserva el derecho de ajustar los límites de solicitudes según sea necesario para proteger nuestro sistema. Aunque los cambios son poco frecuentes, nuestro objetivo es avisar con antelación siempre que sea posible.

Límites de solicitudes globales

Estos límites se aplican a todos los puntos finales de API, y algunos puntos finales tienen límites más restrictivos. Consulte la sección “Límites de solicitudes a nivel de terminal” para obtener detalles específicos.

Por token: cada token de acceso a la API puede realizar hasta 10 solicitudes de API por segundo.
Por organización: cada organización puede realizar hasta 50 solicitudes de API por segundo

En otras palabras, un único token API solo puede realizar 10 solicitudes por segundo. Una organización puede tener varios tokens API, pero en conjunto, una organización solo puede realizar 50 solicitudes por segundo.

Límites de solicitudes a nivel de terminal

Algunos puntos finales tienen límites de solicitudes específicos para gestionar el tráfico y garantizar un uso justo. Estos límites anulan los límites de solicitudes globales cuando se especifican. Para terminales sin reglas específicas, se aplican límites de solicitudes predeterminados como se describe a continuación. La tabla proporciona detalles sobre límites de solicitudes, períodos, respuestas y acciones tomadas cuando se exceden los límites.

Definiciones clave

Límite de solicitudes: El número máximo de solicitudes permitidas dentro del período especificado.
Período: La duración en la que se aplica el límite de solicitudes. Por ejemplo, “1 minuto” significa que el límite se restablece cada minuto.
Respuesta: El código de estado HTTP se devuelve cuando se excede el límite de velocidad.
Acción: La acción que se toma cuando se excede el límite de tasa, lo que generalmente resulta en el bloqueo de más solicitudes hasta que se restablezca el período.

Punto final	Umbral	Periodo	Respuesta	Acción
Predeterminado (todos los demás puntos finales)	10 solicitudes por minuto	3 minutos	429 Demasiadas solicitudes	Bloquear
OBTENER /api/p/v{version}/drivers/{id}	10 solicitudes por minuto	3 minutos	429 Demasiadas solicitudes	Bloquear
OBTENER /api/p/v{version}/drivers	5 solicitudes por minuto	1 minuto	429 Demasiadas solicitudes	Bloquear
ENVIAR /api/p/v{version}/drivers/search	10 solicitudes por minuto	1 minuto	429 Demasiadas solicitudes	Bloquear
ENVIAR /api/p/v{version}/drivers/events/search	10 solicitudes por minuto	3 minutos	429 Demasiadas solicitudes	Bloquear
OBTENER /api/p/v{version}/fuel/{id}	10 solicitudes por minuto	3 minutos	429 Demasiadas solicitudes	Bloquear
ENVIAR /api/p/v{version}/fuel/search	5 solicitudes por minuto	1 minuto	429 Demasiadas solicitudes	Bloquear
OBTENER /api/p/v{version}/invoices	5 solicitudes por minuto	3 minutos	429 Demasiadas solicitudes	Bloquear
ENVIAR /api/p/v{version}/invoices/search	10 solicitudes por minuto	3 minutos	429 Demasiadas solicitudes	Bloquear
OBTENER /api/p/v{version}/loads	5 solicitudes por minuto	3 minutos	429 Demasiadas solicitudes	Bloquear
ENVIAR /api/p/v{version}/loads/search	10 solicitudes por minuto	3 minutos	429 Demasiadas solicitudes	Bloquear
OBTENER /api/p/v{version}/maintenance/{id}	10 solicitudes por minuto	3 minutos	429 Demasiadas solicitudes	Bloquear
ENVIAR /api/p/v{version}/maintenance/search	10 solicitudes por minuto	1 minuto	429 Demasiadas solicitudes	Bloquear
OBTENER /api/p/v{version}/tolls/{id}	10 solicitudes por minuto	3 minutos	429 Demasiadas solicitudes	Bloquear
ENVIAR /api/p/v{version}/tolls/search	10 solicitudes por minuto	1 minuto	429 Demasiadas solicitudes	Bloquear
OBTENER /api/p/v{version}/trailers/{id}	10 solicitudes por minuto	3 minutos	429 Demasiadas solicitudes	Bloquear
OBTENER /api/p/v{version}/trailers	5 solicitudes por minuto	3 minutos	429 Demasiadas solicitudes	Bloquear
ENVIAR /api/p/v{version}/trailers/search	10 solicitudes por minuto	3 minutos	429 Demasiadas solicitudes	Bloquear
ENVIAR /api/p/v{version}/trailers/events/search	10 solicitudes por minuto	3 minutos	429 Demasiadas solicitudes	Bloquear
OBTENER /api/p/v{version}/trips	5 solicitudes por minuto	3 minutos	429 Demasiadas solicitudes	Bloquear
ENVIAR /api/p/v{version}/trips/search	10 solicitudes por minuto	3 minutos	429 Demasiadas solicitudes	Bloquear
OBTENER /api/p/v{version}/trucks/{id}	10 solicitudes por minuto	3 minutos	429 Demasiadas solicitudes	Bloquear
OBTENER /api/p/v{version}/trucks	5 solicitudes por minuto	3 minutos	429 Demasiadas solicitudes	Bloquear
ENVIAR /api/p/v{version}/trucks/search	10 solicitudes por minuto	3 minutos	429 Demasiadas solicitudes	Bloquear
ENVIAR /api/p/v{version}/trucks/events/search	10 solicitudes por minuto	3 minutos	429 Demasiadas solicitudes	Bloquear
OBTENER /api/p/v{version}/users/list	5 solicitudes por minuto	3 minutos	429 Demasiadas solicitudes	Bloquear
ENVIAR /api/p/v{version}/users/search	10 solicitudes por minuto	3 minutos	429 Demasiadas solicitudes	Bloquear

Reglas de limitación de tasa predeterminadas

Para todos los puntos finales sin límites de solicitudes específicos definidos, se aplican las siguientes reglas de limitación de velocidad predeterminadas:

Nombre de la regla: Límite de tasa predeterminado
Ruta URL: /api/*
Umbral: 10 solicitudes por minuto
Explosión: 1 solicitud en el primer segundo
Acción: Bloquear
Período: 3 minutos
Respuesta: 429 Demasiadas solicitudes
Respuesta personalizada: Incluir encabezado Retry-After: 60

Gestión de límites de solicitudes

Cuando una aplicación excede el límite de velocidad especificado, la API responderá con un código de estado 429 Demasiadas solicitudes. La respuesta incluye un encabezado Retry-After, que indica el tiempo en segundos antes de que el cliente pueda volver a intentar la solicitud. Respetar este encabezado es esencial para evitar mayores limitaciones de velocidad y garantizar el acceso continuo a la API.

Ejemplo de encabezado de respuesta

Encabezado	Descripción
Reintentar después	Tiempo de espera sugerido (en segundos) antes de volver a intentarlo (p. ej., `Retry-After: 60`)

Debe respetar el encabezado Retry-After para retrasar adecuadamente futuras solicitudes y evitar activar límites de solicitudes adicionales. Cumplir con estos límites de solicitudes ayuda a mantener la estabilidad y confiabilidad de los servicios API Alvys. Para más consultas o soporte, comuníquese con nuestro equipo de soporte técnico.

​Límites de solicitudes globales

​Límites de solicitudes a nivel de terminal

​Definiciones clave

​Reglas de limitación de tasa predeterminadas

​Gestión de límites de solicitudes

​Ejemplo de encabezado de respuesta

Límites de solicitudes globales

Límites de solicitudes a nivel de terminal

Definiciones clave

Reglas de limitación de tasa predeterminadas

Gestión de límites de solicitudes

Ejemplo de encabezado de respuesta