Limites de requêtes

Chaque compte peut effectuer 30 appels de création de liens par fenêtre de 60 secondes, partagés entre REST POST /api/v1/links, POST /api/v1/uploads, POST /api/v1/sheets et MCP create_links. Chaque réservation de téléversement et soumission de feuille utilise un appel ; les conversions de liens dérivées n’en utilisent aucun. Une requête avec réponse immédiate et une soumission de lot utilisent chacune un appel, quel que soit le nombre d’entrées.

Les requêtes de création admises et les refus pour dépassement de limite comportent des en-têtes structurés :

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

q est le quota et w sa fenêtre en secondes. r est le nombre d'appels restants ; t est le délai en secondes avant qu'une place se libère. Ce sont des champs structurés, pas des nombres isolés.

L'épuisement du quota renvoie 429 avec le problème rate-limited et Retry-After en secondes. Attendez avant de réessayer et coordonnez les clients qui utilisent le même compte. La lecture des tâches ne consomme pas ce quota de création de liens ; suivez les indications poll_after_seconds et Retry-After.

Fenêtre de rechercheCopier le lien de la section

Les recherches par mots-clés disposent d’une fenêtre distincte par compte de 30 appels par période de 60 secondes. L’admission de la recherche ne consomme aucun appel de création de liens. Les liens collés résolus de produits, boutiques, feuilles et sites non pris en charge évitent la recherche par mots-clés et ne consomment aucune fenêtre ; les liens non lus peuvent aboutir à la recherche par mots-clés.

Les réponses réussies qui atteignent l’admission de la recherche par mots-clés et les refus pour limite de recherche comportent :

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

Les refus de recherche renvoient 429 avec search-rate-limited et Retry-After. Les champs des en-têtes ont la même signification que ci-dessus. Reproduire une requête de création avec Idempotency-Key ne consomme aucun nouvel appel de création de liens ; une réponse 429 n’est pas enregistrée pour reproduction.