Límites de solicitudes

Cada cuenta puede hacer 30 llamadas de creación de enlaces por ventana de 60 segundos, compartidas entre REST POST /api/v1/links, POST /api/v1/uploads, POST /api/v1/sheets y MCP create_links. Cada reserva de carga y envío de hoja usa una llamada; las conversiones de enlaces derivadas no usan ninguna. Tanto una solicitud con respuesta inmediata como el envío de un lote usan una llamada, sin importar cuántas entradas contengan.

Las solicitudes de creación admitidas y los rechazos por límite de solicitudes incluyen encabezados estructurados:

RateLimit-Policy: "create-links";q=30;w=60
RateLimit: "create-links";r=29;t=60

q es la cuota y w su ventana en segundos. r son las llamadas restantes; t son los segundos hasta que se libere un espacio. Son campos estructurados, no números sueltos.

Agotar la cuota devuelve 429 con el problema rate-limited y Retry-After en segundos. Espera antes de reintentar y coordina los clientes que usan la misma cuenta. Las lecturas de trabajos no consumen esta cuota de creación de enlaces; sigue sus indicaciones de poll_after_seconds y Retry-After.

Ventana de búsquedaCopiar enlace a esta sección

Las búsquedas por palabras clave tienen una ventana independiente por cuenta de 30 llamadas cada 60 segundos. La admisión de búsqueda no consume llamadas de creación de enlaces. Los enlaces pegados resueltos de productos, tiendas, hojas y sitios no compatibles omiten la búsqueda por palabras clave y no consumen ninguna ventana; los que no se pudieron leer pueden llegar a la búsqueda por palabras clave.

Las respuestas exitosas que llegan a la admisión de búsqueda por palabras clave y los rechazos por límite de búsqueda incluyen:

RateLimit-Policy: "search";q=30;w=60
RateLimit: "search";r=29;t=60

Los rechazos de búsqueda devuelven 429 con search-rate-limited y Retry-After. Los campos de los encabezados significan lo mismo que arriba. Reproducir una solicitud de creación con Idempotency-Key no consume otra llamada de creación de enlaces; un 429 no se almacena para reproducirlo.