Che cos’è un limite di richieste API? — Strumento gratuito
Un limite di richieste API è il tetto che una piattaforma pone al numero di chiamate che un’applicazione può fare in una finestra di tempo. Cosa succede quando uno strumento lo raggiunge, perché è un ritardo e non un errore, e cosa comporta per pianificazione e statistiche.
Il tetto che una piattaforma impone al numero di richieste API che un'app può fare in un intervallo di tempo. Raggiungerlo fa fallire temporaneamente gli strumenti di pubblicazione o analisi finché l'intervallo non si azzera.
Che cos’è
Un limite di richieste è il tetto che una piattaforma pone al numero di chiamate API che un’applicazione può fare in una finestra fissa: tante chiamate ogni quarto d’ora, ogni ora o ogni giorno. Esiste perché una sola applicazione non consumi una capacità che è di tutti, e si applica all’applicazione, non a te.
Come si misura
La finestra è la parte che conta e quella che si salta. Un limite di mille chiamate all’ora non significa mille chiamate distribuite; significa che l’applicazione può spendere tutta la dotazione in un minuto e poi aspettare cinquantanove. Quando la dotazione finisce, la piattaforma risponde con un 429, spesso con un header che indica quando la finestra si azzera. Gli strumenti fatti bene leggono quell’header e aspettano. Gli altri riprovano subito, vengono rifiutati di nuovo, e trasformano un ritardo in un errore segnalato.
Frainteso spesso
Sembra che ci sia qualcosa che non va nel tuo account, e non è così. Nulla in un limite di richieste è un giudizio sul tuo profilo, sui tuoi contenuti o sulla tua posizione, ed è proprio per questo che un ritardo di pubblicazione dovuto a un limite si risolve da solo senza che tu cambi nulla. La confusione vicina è con una sospensione: da fuori, un’applicazione limitata e una a cui è stato revocato l’accesso sembrano entrambe "ha smesso di funzionare". La differenza è che un limite dice quando finisce.
Quando conta
Conta quando succede molto tutto insieme: un lotto grande programmato per lo stesso minuto, un mese di statistiche recuperato a ritroso, o più account aggiornati insieme. Per questo gli strumenti di pubblicazione distribuiscono il lavoro invece di lanciare tutto allo scoccare dell’ora, e per questo una metrica che manca stamattina di solito c’è nel pomeriggio.
Termini correlati
Caratteristiche
- Definizione chiara, con la finestra come parte determinante
- Che cos’è una risposta 429 e perché non è un errore del tuo account
- Perché i buchi nelle statistiche e le pubblicazioni in ritardo hanno spesso la stessa causa
- Come gli strumenti fatti bene attendono invece di riprovare subito
- La differenza tra un limite di richieste e una sospensione, che da fuori si somigliano
Domande frequenti
Cosa succede quando si raggiunge un limite?
La piattaforma rifiuta le richieste successive finché la finestra non si azzera, di solito con una risposta 429. Uno strumento ben costruito aspetta e riprova; uno costruito male segnala un errore che non è mai stato tuo.
Raggiungere un limite danneggia il mio account?
No. È un tetto su un’applicazione, non una sanzione su di te. Insistere contro il limite invece di aspettare può far limitare l’applicazione stessa, ma riguarda la sua posizione e non il tuo profilo.
Perché manca un giorno nelle mie statistiche?
Un limite di richieste è una delle cause abituali. Le metriche si raccolgono chiedendo alla piattaforma post per post, quindi una finestra esaurita lascia un buco che si riempie al passaggio successivo invece di non arrivare mai.
È la stessa cosa di uno shadowban?
No, anche se si confondono perché entrambi sembrano qualcosa che in silenzio ha smesso di funzionare. Un limite di richieste è un tetto documentato con un orario di azzeramento e un codice di risposta esplicito. Un calo di distribuzione non ha né l’uno né l’altro.
Posso alzare il limite?
Non da utente di uno strumento. I limiti li fissa la piattaforma per applicazione e dipendono dal livello di accesso concesso, quindi la risposta sta sempre dal lato dello strumento e non nelle tue impostazioni.
