AccediInizia la prova gratuita
easyCoexistence API ufficiali

Errore TikTok 40100: richieste inviate troppo frequentemente

Il codice 40100 di TikTok indica che una limitazione di frequenza ha rallentato la richiesta: TikTok lo restituisce nel corpo di una risposta HTTP 200, quindi lo stato HTTP da solo non lo mostra. La soluzione è sospendere le chiamate a quell'endpoint, per 5 minuti dopo un limite al minuto o fino alle 00:00 UTC dopo un limite giornaliero, poi inviare meno richieste, ma più grandi.

easyCoexistence restituisce a Claude, ChatGPT o al tuo codice il codice e il messaggio di TikTok, così la tua AI può distinguere un limite di frequenza da un post fallito e attendere prima di riprovare.

40100

Il codice che TikTok restituisce quando un limite di frequenza viene raggiunto, cioè la richiesta è stata limitata.

HTTP 200

Lo stato che TikTok invia con i suoi codici di ritorno, incluso 40100; solo il codice 0 nel corpo indica successo.

40 QPM

Il limite di frequenza dell'API Accounts per ogni account TikTok autorizzato su ciascun endpoint.

600 QPM

Tutti gli endpoint dell'API Accounts combinati, per app per sviluppatori al livello Basic; i livelli superiori ne consentono 1.000.

5 minutes

Quanto TikTok dice di attendere prima di chiamare di nuovo dopo aver raggiunto un limite al minuto.

15 a day

Il numero massimo di post video che un account può pubblicare tramite API in un giorno, con al massimo sei al minuto.

Che cosa significa l'errore 40100?

Un limite di frequenza ha bloccato la richiesta. L'appendice dei codici di ritorno di TikTok descrive il 40100 come richieste inviate troppo frequentemente, perché il limite dell'endpoint a livello di app per sviluppatori è stato raggiunto, e la guida ai limiti di frequenza dice che il server restituisce 40100 appena un limite viene raggiunto. Le chiamate a quell'endpoint devono fermarsi finché la sospensione non termina.

Come rilevare il 40100 nel codice?

Dal codice nel corpo, non dallo stato HTTP. TikTok invia i suoi codici di ritorno con HTTP 200, quindi controlla il campo code di ogni risposta: 0 indica successo e 40100 una richiesta limitata. Uno stato 4xx indica un percorso o un metodo sbagliato, e con un 5xx TikTok consiglia di attendere circa 5 minuti prima di riprovare:

Reading TikTok's answer in Node.js
// TikTok returns its error codes with HTTP 200: read code, not only the status.
async function callTikTok(url, accessToken) {
  const res = await fetch(url, { headers: { "Access-Token": accessToken } });
  if (res.status >= 500) return { retryInMs: 5 * 60_000 }; // TikTok: wait about 5 minutes
  if (!res.ok) throw new Error("HTTP " + res.status + ": check the path and the method");
  const body = await res.json();
  if (body.code === 40100) return { retryInMs: 5 * 60_000 }; // throttled: pause this endpoint
  if (body.code !== 0) throw new Error("TikTok " + body.code + ": " + body.message);
  return { data: body.data };
}

Quali limiti possono restituire il 40100?

La guida ai limiti di frequenza di TikTok dice che il server restituisce 40100 appena un limite viene raggiunto, e ciascun limite viene conteggiato separatamente, con i valori completi per livello di app nella pagina dei limiti di frequenza. Una chiamata all'API Accounts ne conta tre:

  • 40 query al minuto per ogni account autorizzato su ciascun endpoint dell'API Accounts, uguale a ogni livello di app.
  • 600 query al minuto nell'API Accounts per app per sviluppatori al livello Basic, e 1.000 sopra.
  • Limiti per endpoint dell'app, al secondo, al minuto e al giorno, stabiliti dal livello dell'app.

Quanto bisogna aspettare?

Dipende dal limite raggiunto. Dopo un limite al minuto, TikTok dice di attendere 5 minuti prima di chiamare di nuovo. Dopo un limite giornaliero, attendi il giorno successivo, perché i limiti giornalieri si azzerano alle 00:00:00 UTC. La guida di TikTok aggiunge che i limiti specifici per endpoint sono indipendenti, quindi raggiungere il limite di un endpoint non blocca le chiamate a un altro.

Il tetto di 15 post al giorno è lo stesso limite?

No. Il tetto di pubblicazione conta i post, sei al minuto e 15 al giorno per account su ciascun endpoint di pubblicazione, e un post oltre il tetto fallisce nel suo stato di pubblicazione con spam_risk_too_many_posts, non con 40100. Il consiglio di TikTok per questo errore è pubblicare il post dall'app mobile di TikTok, e la pagina sui limiti di pubblicazione lo spiega.

Come restare sotto i limiti?

Il consiglio di TikTok è fare meno richieste, ma più grandi, e limitare quante ne girano in parallelo. Sull'API Accounts questo significa leggere fino a 20 post per pagina di /business/video/list/ e fino a 30 commenti per pagina di /business/comment/list/, invece di recuperarli uno alla volta, distanziare le chiamate con un token bucket, oppure metterle in coda, così un numero fisso di worker le invia e le attività fallite tornano in coda dopo un ritardo.

Un livello di app più alto ferma il 40100?

Solo quando il limite raggiunto è quello dell'app. Ogni app parte dal livello Basic, e TikTok lo alza un livello alla volta, da Basic ad Advanced, poi Premium e Ultimate, con una richiesta fatta da My Apps, App Detail, Authorization che indichi un motivo. La guida all'API Accounts di TikTok indica il limite di 40 al minuto per account e per endpoint come un valore unico, separato dal livello dell'app, quindi un account molto attivo si risolve distanziando le sue chiamate.

Errori comuni

  • Riprovare subito. L'endpoint resta limitato finché la sospensione non termina, quindi i tentativi rapidi consumano chiamate senza passare.
  • Recuperare post o commenti uno alla volta. Una chiamata di elenco restituisce una pagina di fino a 20 post o 30 commenti, e ogni chiamata conta verso le 40 al minuto.
  • Controllare lo stato di pubblicazione in un ciclo serrato. Ogni verifica è una chiamata a /business/publish/status/, e gli ID dei post possono impiegare fino a tre minuti per comparire, quindi distanziale.
  • Trattare spam_risk_too_many_posts come un limite di frequenza. Conta i post creati tramite API nelle ultime 24 ore, non le chiamate al minuto, quindi rallentare le chiamate non lo risolve.
Farlo con EasyCoexistence

I suoi strumenti leggono i commenti 30 per pagina e i post fino a 20 alla volta, e publish_tiktok_post avvisa subito l'AI che TikTok limita la pubblicazione via API a circa 15 post al giorno per account. Da US$ 9 a US$ 0,75 per connessione al mese, in calo man mano che aggiungi connessioni, con la prova gratuita di 3 giorni.

Domande frequenti

TikTok restituisce HTTP 429 quando una chiamata è limitata?

Le guide di TikTok descrivono una chiamata limitata come codice 40100 nel corpo di una risposta HTTP 200, e non citano alcuno stato 429, quindi controlla il campo code di ogni risposta.

Quanto dura un limite 40100 di TikTok?

TikTok dice di attendere 5 minuti dopo aver raggiunto un limite al minuto. Un limite giornaliero si esaurisce alle 00:00:00 UTC, quando si azzera.

easyCoexistence riprova una chiamata che restituisce 40100?

Non da solo. Una chiamata a uno strumento limitata torna alla tua AI con codice 40100 e il messaggio di TikTok, mentre un post limitato in coda fallisce con quel messaggio e resta in Richiede attenzione finché non scegli Riprova.

40100 è diverso da 40016?

L'appendice di TikTok dà a entrambi la stessa descrizione, richieste inviate troppo frequentemente a livello di app per sviluppatori, e la stessa soluzione: consulta la guida ai limiti di frequenza. Il 40133 riguarda il livello dell'inserzionista.

Continua a leggere

Collega il tuo primo canale in due minuti.

Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.

  • 3 giorni gratis
  • Disdici quando vuoi
  • Solo API ufficiali
  • Monitorato 24/7

Verificato il