Límites de frecuencia
Los presupuestos son por clave y por minuto, con ventanas separadas para lecturas y escrituras.
Cada clave de API tiene un presupuesto por minuto que fija el plan del espacio de trabajo. GET /me lo informa como limits.apiRequestsPerMinute. Las escrituras (POST, PATCH, DELETE) usan un presupuesto aparte, de un tercio del tamaño, así que una ráfaga de lecturas nunca bloquea una actualización necesaria, ni al revés.
Cada respuesta incluye el estado del presupuesto que usó la solicitud:
| Encabezado | Significado |
|---|---|
X-RateLimit-Limit | Solicitudes permitidas por minuto para esta clave y este tipo de solicitud |
X-RateLimit-Remaining | Solicitudes que quedan en la ventana actual |
X-RateLimit-Reset | Hora Unix (en segundos) en que se reinicia la ventana |
Cuando se agota el presupuesto, la API responde 429 rate_limited con un encabezado Retry-After en segundos. Espera ese tiempo y vuelve a intentarlo; no aceleres el ciclo de reintentos.
La creación masiva tiene su propio límite de diez lotes cada diez minutos por clave, además del presupuesto de escritura.