Puntos destacados
Las respuestas de cuota excedida ahora devuelven HTTP 429 con un encabezado Retry-After, coincidiendo con lo que envían OpenAI, GitHub y Cloudflare. La página de precios sumó una fila de ancho de banda (todo plan público es ilimitado). Además, las solicitudes que piden exitCountries en un plan sin segmentación geográfica ahora obtienen un limpio 403 que indica el parámetro y la solución.
Novedades
Los límites de cuota ahora dicen HTTP 429, no 402
Si alcanzas un límite del plan (créditos o ancho de banda), la respuesta es 429 Too Many Requests con Retry-After en cada respuesta y resets_at en el cuerpo apuntando al final de tu período de facturación. El campo reason te indica qué límite alcanzaste (plan_limit_credits o plan_limit_bandwidth) para que no choque con los rate limits por minuto.
¿Por qué el cambio? 402 suena bien ("Payment Required"), pero en la práctica así es como Stripe reporta los cobros fallidos, y varios clientes HTTP y proxies lo manejan mal. OpenAI, GitHub, Twilio y Cloudflare rechazan las cuotas excedidas con 429 y un código de error distinto. Seguir a la manada aquí es lo correcto: toda biblioteca de reintentos del planeta ya sabe qué hacer con nuestras respuestas.
El valor de Retry-After tiene un límite de 24 horas para los que duermen y reintentan. Si quieres el tiempo de reinicio real, lee resets_at del cuerpo JSON.
Ancho de banda en la página de precios: Ilimitado
/prices sumó una fila de ancho de banda en la matriz de comparación. Todo plan público ofrece ancho de banda sin límite, y la matriz ahora lo dice claramente. Es el tipo de cosa que no necesitas hasta que un prospecto pregunta y no puedes encontrar el número. Ahora está en la página.
Los planes personalizados que limitan el ancho de banda muestran su cifra en GB en la misma fila.
la segmentación geográfica se bloquea a sí misma con un error adecuado
Si una solicitud envía exitCountries mientras el plan no incluye la función de segmentación geográfica, la respuesta es 403 con un mensaje que nombra el parámetro y cómo solucionarlo. Antes, la solicitud pasaba como si se permitiera la segmentación geográfica. Ahora falla ruidosamente en la puerta.
Las solicitudes sin exitCountries no se ven afectadas. Esto solo se activa cuando realmente estás pidiendo la función.
Pequeñas correcciones del Panel en Límites y Facturación
Tres arreglos de calidad de vida:
- Pestaña de límites. La sub-pestaña guardada (Visión general / Claves de API / Límites y características) se restaura antes de pintar, por lo que ya no ves un parpadeo de pestaña incorrecta al recargar.
- Claves de API. El cuadro de búsqueda utiliza el patrón de búsqueda canónico en lugar de un input vacío.
- Facturación. Las líneas meta debajo de Método de pago ahora se renderizan con el estilo correcto (antes se mostraban sin estilo).
Bajo el capó
Los modos de cumplimiento de límites de plan ahora se pueden cambiar en vivo. Cada uno de los seis límites del data-plane (concurrencia por producto, tasa por minuto, navegador por día, créditos, ancho de banda, características) más la verificación de creación de clave del control-plane se pueden cambiar entre apagado, señal y cumplir desde un panel de configuración que controla nuestro equipo. Sin redespliegues. Un actualizador en segundo plano consulta la configuración cada 60 segundos y la ruta caliente permanece sincrónica.
¿Por qué te importa esto? Cuando un límite falla en producción, podemos ajustarlo en un minuto en lugar de desplegar código nuevo. También nos permite aplicar las restricciones gradualmente, por límite, observando qué hace el tráfico real en cada paso. El modo de señal registra el evento sin bloquear; el modo estricto activa la respuesta 429 o 403. Queríamos que el paso intermedio fuera de primera clase en lugar de un interruptor de emergencia.
Números
Retry-Afterlímite de rechazos de cuota: 24 horas (tiempo real de reinicio enresets_at)- Intervalo de consulta de configuraciones en tiempo de ejecución: 60 segundos
- Planes públicos con ancho de banda sin límite: todos
El limitador de planes ha sido el hilo conductor durante un mes. Lo siguiente: aplicación de los primeros límites (créditos y concurrencia por producto parecen el primer par natural), además de advertencias por correo electrónico una vez que se lance la fase de envíos.