Limiti di richieste

Ogni account può effettuare 30 chiamate di creazione di link per finestra di 60 secondi, condivise tra REST POST /api/v1/links, POST /api/v1/uploads, POST /api/v1/sheets e MCP create_links. Ogni prenotazione di caricamento e invio di foglio usa una chiamata; le conversioni dei link derivate non ne usano nessuna. Una richiesta con risposta immediata e l’invio di un batch usano una chiamata ciascuno, indipendentemente dal numero di input.

Le richieste di creazione ammesse e i rifiuti per superamento del limite includono header strutturati:

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

q è la quota e w la sua finestra in secondi. r indica le chiamate rimanenti; t i secondi fino a quando si libera uno slot. Sono campi strutturati, non semplici numeri.

Esaurire la quota restituisce 429 con il problema rate-limited e Retry-After in secondi. Attendi prima di riprovare e coordina i client che usano lo stesso account. Le letture delle operazioni non consumano questa quota di creazione dei link; segui le indicazioni poll_after_seconds e Retry-After.

Finestra di ricercaCopia link alla sezione

Le ricerche per parole chiave hanno una finestra separata per account di 30 chiamate ogni 60 secondi. L’ammissione della ricerca non consuma chiamate di creazione link. I link incollati risolti di prodotti, negozi, fogli e siti non supportati saltano la ricerca per parole chiave e non consumano nessuna finestra; i link non letti possono raggiungere la ricerca per parole chiave.

Le risposte riuscite che raggiungono l’ammissione della ricerca per parole chiave e i rifiuti per limite di ricerca includono:

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

I rifiuti di ricerca restituiscono 429 con search-rate-limited e Retry-After. I campi degli header hanno lo stesso significato descritto sopra. Riprodurre una richiesta di creazione con Idempotency-Key non consuma una nuova chiamata di creazione link; una risposta 429 non viene memorizzata per la riproduzione.