Conceptos
Límites de uso
Cuántas peticiones por minuto, y qué significa exactamente ese número.
120 peticiones por minuto y por credencial. Por encima, 429 rate_limited
con una cabecera Retry-After.
El contador vive en la memoria del proceso. Como la API corre sin servidor, el techo real es por instancia: trátalo como una barrera contra un bucle descontrolado, no como una cuota exacta que puedas apurar.
El límite se aplica igual a una clave de API, a un token OAuth y al conector MCP: es la misma credencial resuelta por el mismo camino.
Cómo no acercarte al límite
Deja de consultar. Si lo que quieres saber es « ¿se cerró este negocio? », un webhook te lo dice en el momento y cuesta cero peticiones. Consultar una lista cada minuto cuesta 1 440 peticiones al día para enterarte tarde.
Pide páginas grandes. ?limit=100 es el máximo, y una página de 100 cuesta
lo mismo que una de 25.
Pagina con el cursor, no con el desplazamiento. meta.next_cursor es un
cursor de clave sobre created_at, id: no se salta filas ni las repite cuando
alguien inserta un lead mientras recorres la lista.
El registro dinámico tiene su propio límite
POST /api/oauth/register acepta 10 registros por hora y por IP. Es un
límite aparte, y también en memoria de proceso. Lo que hace seguro ese endpoint
no es el contador: es que un registro no concede nada — ver
Conectar un asistente.