Contenido
- ¿Qué es la limitación de tasa?
- Configuración predeterminada
- ¿Cuándo ocurre la limitación de tasa?
- Nuestro proceso de comunicación
- Cómo identificar la limitación de tasa
- Qué hacer cuando se alcanzan los límites de tasa
- Configuración de límites de tasa
- ¿Necesitas ayuda?
1. ¿Qué es la limitación de tasa?
La limitación de tasa es un mecanismo de protección que controla el número de solicitudes de API que tu integración puede realizar a Urbantz dentro de un período de tiempo específico. Esto garantiza la estabilidad del sistema y un rendimiento óptimo para todos los clientes.
2. Configuración predeterminada
De forma predeterminada, la plataforma Urbantz no tiene límites de tasa.
Los límites de tasa solo se implementan de forma reactiva cuando nuestros sistemas de monitoreo detectan patrones de uso de la API que podrían afectar negativamente el rendimiento o la estabilidad de la plataforma para otros clientes.
3. ¿Cuándo ocurre la limitación de tasa?
Los límites de tasa se aplican solo en circunstancias específicas:
- Volumen de solicitudes anormal: Números inusualmente altos de solicitudes en un corto período de tiempo
- Patrones de uso de API ineficientes: Solicitudes repetidas que podrían optimizarse
- Operaciones con uso intensivo de recursos: Llamadas frecuentes a endpoints que consumen muchos recursos y afectan el rendimiento general del sistema
4. Nuestro proceso de comunicación
Si detectamos un uso problemático de la API, nuestros equipos te informarán antes o inmediatamente después de implementar los límites de tasa.
Nuestra comunicación incluirá:
- Los patrones de uso que observamos - Métricas específicas y ejemplos de las llamadas de API que generan preocupación
- Por qué estos patrones son problemáticos - Cómo el uso afecta el rendimiento o la estabilidad del sistema
- Los límites de tasa que se están implementando - Umbrales específicos y lo que significan para tu integración
- Recomendaciones - Cómo ajustar tu integración para trabajar dentro de los límites
Trabajamos de forma colaborativa con nuestros clientes para garantizar que los límites de tasa necesarios sean razonables para su caso de uso, al tiempo que protegemos la estabilidad de la plataforma.
5. Cómo identificar la limitación de tasa
Limitación de tasa de la aplicación Urbantz
Cuando Urbantz aplica la limitación de tasa, tus solicitudes recibirán:
HTTP 429 - Too Many Requests
Cuerpo de respuesta:
{
"code": "040-000"
}
Este código de error indica específicamente que tu solicitud ha sido limitada por la plataforma Urbantz.
Protección del Firewall de Aplicaciones Web (WAF) de Cloudflare
Urbantz utiliza el Firewall de Aplicaciones Web de Cloudflare para la protección contra DDoS. En casos de volúmenes de solicitudes extremadamente altos que se asemejan a un ataque DDoS, Cloudflare puede bloquear las solicitudes antes de que lleguen a los servidores de Urbantz.
Cuando Cloudflare WAF bloquea tus solicitudes, recibirás:
HTTP 403 - Forbidden
La respuesta incluirá una página de error con la marca Cloudflare que indica que la solicitud fue bloqueada por razones de seguridad.
Diferencias clave:
| Fuente | Código HTTP | Cuerpo de respuesta | Causa |
| Urbantz - Limitación de tasa | 429 | {"code": "040-000"} | Límites de tasa configurados en tu plataforma |
| Cloudflare WAF | 403 | Página de error de Cloudflare | Protección DDoS / Volumen de tráfico anormalmente alto |
Si recibes errores HTTP 403 de Cloudflare, esto indica que tu patrón de tráfico está siendo identificado como potencialmente malicioso. Esto es independiente de la limitación de tasa a nivel de aplicación de Urbantz y normalmente indica una anomalía de tráfico más grave.
6. Qué hacer cuando se alcanzan los límites de tasa
Para HTTP 429 (Limitación de tasa de Urbantz)
- Implementa lógica de reintentos con retroceso exponencial en tu integración para gestionar la limitación de tasa temporal de forma eficaz
- Revisa la comunicación de Urbantz - Habremos proporcionado detalles sobre los patrones de uso que activaron el límite de tasa
- Optimiza tu integración según nuestras recomendaciones
-
Contacta con el soporte de Urbantz si necesitas:
- Aclaración sobre los límites de tasa implementados
- Orientación técnica sobre cómo optimizar tu integración
- Discusión sobre tu caso de uso específico y tus requisitos
Para HTTP 403 (Cloudflare WAF)
- Reduce inmediatamente el volumen de tus solicitudes - Esto indica que tu patrón de tráfico se asemeja a un ataque DDoS
-
Revisa la arquitectura de tu integración:
- ¿Estás realizando solicitudes en grandes ráfagas?
- ¿Estás implementando correctamente los retrasos entre solicitudes?
- ¿Hay múltiples instancias de tu aplicación ejecutándose involuntariamente?
-
Contacta con el soporte de Urbantz y proporciona:
- Marcas de tiempo de cuándo ocurrieron los bloqueos
- La arquitectura de tu integración y los patrones de tráfico esperados
- Cualquier cambio reciente en tu integración
- Capturas de pantalla de la página de error de Cloudflare
Trabajaremos contigo para distinguir el tráfico legítimo de alto volumen de los patrones de ataque y ajustar las protecciones en consecuencia.
Configuración de límites de tasa
Los límites de tasa en Urbantz se configuran por plataforma y se adaptan a la situación específica de cada cliente en función de los patrones de uso observados y los requisitos de la plataforma.
¿Necesitas ayuda?
Si recibes errores de limitación de tasa o deseas hablar sobre el uso de la API de tu integración, ponte en contacto con el soporte de Urbantz y comparte lo siguiente:
- La URL de tu plataforma
- Códigos de estado HTTP recibidos (429 vs 403)
- Marcas de tiempo de cuándo ocurrió la limitación de tasa
- Descripción de tu caso de uso y arquitectura de integración
- Registros de errores o capturas de pantalla relevantes
Nuestro equipo trabajará contigo para garantizar que tu integración esté optimizada y que los límites de tasa estén configurados adecuadamente para tus necesidades.
Comentarios
0 comentarios
Inicie sesión para dejar un comentario.