Límites de uso
Dos familias de límites - lo que permite el plan y con qué rapidez se puede llamar a un endpoint - con los números servidos por la API que los aplica.
cmssy aplica dos tipos distintos de límite, y responden a preguntas distintas. Una asignación de plan dice cuánto producto compró tu organización: páginas, almacenamiento, peticiones de delivery al mes. Un guardia de protección dice con qué rapidez puede cualquiera llamar a un endpoint, en cualquier plan. Una petición puede caber de sobra en tu asignación y aun así ser rechazada por un guardia, y es el guardia el que responde 429.
Qué significa un 429
Todos los guardias rechazan igual: HTTP 429 con una cabecera Retry-After que lleva los segundos que faltan para que la ventana se reabra. Espera ese tiempo y reintenta.
La ventana es fija, no un cubo que se vacía mientras llamas a la puerta. Un cliente que trata el 429 como un 500 y reintenta de inmediato seguirá rechazado el resto de la ventana, y quemará su propia capacidad haciéndolo. Lee la cabecera.
El delivery se presupuesta por workspace
La API de delivery es la que llamas desde tu propio servidor, así que su presupuesto es por workspace, no por llamante. Cada visitante de tu sitio se renderiza desde un puñado de tus IP regionales, y un crawler calentando una caché fría gastaría un presupuesto por llamante en segundos. La segunda fila de delivery es esa red antiabuso más ancha, contada por dirección - la dirección que nos llega, lleve el token que lleve - y no el presupuesto con el que funciona tu sitio.
Un sitio que se renderiza en su propio servidor puede decirnos para qué visitante es una petición: envía la dirección del visitante en x-cmssy-client-ip junto con un token de API limitado al workspace en x-cmssy-api-token, y cada presupuesto por dirección - delivery, carrito, inicio de sesión de miembros, envíos de formularios - se cuenta por visitante en lugar de por servidor. El par solo se acepta cuando el token pertenece a este workspace y su propietario sigue teniendo acceso; guárdalo en el servidor, nunca en un navegador. El token se valida una vez por minuto y por servidor, y esa validación le cuesta a tu servidor un slot de su propio presupuesto de delivery. Mientras el par se acepta, Retry-After y las cabeceras X-RateLimit-* describen el cubo del visitante, y X-RateLimit-Scope indica el ámbito que respondió: workspace o caller.
Cada lectura cuenta, esté cacheada o no. Un CDN delante de tu sitio es justo lo que te mantiene dentro del presupuesto, porque corta las lecturas que llegan hasta nosotros - pero una lectura que sí llega se cuenta, caches la respuesta o no.
La profundidad no es un ritmo
Dos guardias se miden en niveles, no en peticiones: una consulta anidada más profundamente que el límite se rechaza en el acto, y esperar no cambia nada. Aplana la consulta.
Las asignaciones mensuales se comparten
Las asignaciones de plan pertenecen a la organización, no a un workspace. Las peticiones de delivery y el ancho de banda se comparten entre todos los workspaces de la organización y se cuentan por mes natural.
Cómo leer las tablas
Ambas tablas de abajo las sirve la API que aplica los números, así que esta página no puede desviarse del producto. Las filas marcadas como ajustables son las que un operador puede mover para un despliegue; cualquier otro número es igual para todos.