Riferimento Errori API TikTokGuida completa alla risoluzione dei problemi con soluzioni
Riferimento completo per gli errori dell'API TikTok. Trova soluzioni per rilevamento spam, errori formato video, autorizzazioni e limiti di frequenza.
Categorie di Errori
Autenticazione
3 errors
Spam
6 errors
Formato video
6 errors
Media
3 errors
Limite di frequenza
2 errors
Stato app
3 errors
Server
2 errors
Tutti i Codici di Errore
#Autenticazione
access_token_invalidrefresh-tokenIl token di accesso TikTok non è valido. Riconnetti il tuo account TikTok.
Soluzione:
Il tuo token di accesso non è più valido. Vai nelle impostazioni dell'account e riconnetti il tuo account TikTok per ottenere un nuovo token valido.
scope_not_authorizedrefresh-tokenAutorizzazioni TikTok richieste mancanti. Riconnetti con tutti gli ambiti richiesti.
Soluzione:
Non hai concesso tutte le autorizzazioni richieste. Durante la riconnessione, assicurati di approvare tutti gli ambiti richiesti inclusi video.upload e user.info.basic.
scope_permission_missedrefresh-tokenAutorizzazioni aggiuntive richieste, riautentica.
Soluzione:
Sono necessarie autorizzazioni aggiuntive per questa operazione. Riconnetti il tuo account TikTok e assicurati che tutte le autorizzazioni siano concesse.
#Spam
spam_risk_user_banned_from_postinguser-errorAccount bannato dalla pubblicazione. Controlla lo stato del tuo account TikTok.
Soluzione:
Il tuo account TikTok è stato limitato dalla pubblicazione. Accedi direttamente a TikTok per vedere se ci sono avvisi. Potrebbe essere necessario fare ricorso contro la restrizione.
spam_risk_textuser-errorTikTok ha rilevato potenziale spam nel testo del post.
Soluzione:
La tua didascalia o testo è stato contrassegnato come spam. Evita contenuti ripetitivi, link eccessivi o linguaggio promozionale. Prova a pubblicare contenuti diversi.
spam_risk_too_many_postsuser-errorLimite di pubblicazione giornaliero raggiunto. Riprova domani.
Soluzione:
Hai superato il limite di pubblicazione giornaliero di TikTok. Attendi 24 ore prima di pubblicare di nuovo. Considera di distribuire i tuoi post su più giorni.
spam_risk_too_many_pending_shareuser-errorThe daily upload cap from the API is reached for the current user.
Soluzione:
To reduce spamming, TikTok limits the number of videos that can be uploaded via API that are not pending approval and posting by the creator. There may be at most 5 pending shares within any 24-hour period.
spam_riskuser-errorTikTok ha rilevato potenziale spam.
Soluzione:
Il sistema di rilevamento spam di TikTok ha contrassegnato il tuo contenuto. Assicurati che il tuo contenuto sia originale e segua le linee guida della comunità TikTok. Evita post ripetitivi.
reached_active_user_capuser-errorQuota utenti attivi giornaliera raggiunta, riprova più tardi.
Soluzione:
La tua app ha raggiunto il limite giornaliero di utenti attivi. Questo è impostato da TikTok in base allo stato della tua app. Attendi 24 ore o richiedi un aumento della quota.
#Formato video
file_format_check_faileduser-errorIl formato del file non è valido. Controlla le specifiche video di TikTok.
Soluzione:
Il tuo formato video non è supportato. TikTok richiede formato MP4 o WebM. Converti il tuo video e assicurati che soddisfi le specifiche di TikTok.
duration_check_faileduser-errorLa durata del video non è valida. Controlla le specifiche video di TikTok.
Soluzione:
La durata del video deve essere tra 3 secondi e 10 minuti. Taglia il tuo video per rientrare in questi limiti.
frame_rate_check_faileduser-errorIl frame rate del video non è valido. Controlla le specifiche video di TikTok.
Soluzione:
TikTok richiede un frame rate tra 23-60 fps. Ricodifica il tuo video con un frame rate supportato.
picture_size_check_faileduser-errorLa dimensione dell'immagine/video non è valida, deve essere almeno 720p.
Soluzione:
La risoluzione del tuo video è troppo bassa. TikTok richiede una risoluzione minima di 720p. Usa una fonte video di qualità superiore.
video durationuser-errorLa durata del video supera i limiti di TikTok. Usa un video più corto.
Soluzione:
Il tuo video è troppo lungo. La durata massima è di 10 minuti. Modifica il tuo video per accorciarlo o dividilo in più parti.
file sizeuser-errorLa dimensione del file supera i limiti di TikTok. Usa un file più piccolo.
Soluzione:
La dimensione massima del file è tipicamente 287MB per i video. Comprimi il tuo video o riduci la sua qualità per rispettare il limite di dimensione.
#Media
video_pull_faileduser-errorImpossibile recuperare il video dall'URL. Controlla che l'URL del video sia accessibile.
Soluzione:
TikTok non è riuscito a scaricare il tuo video dall'URL fornito. Assicurati che l'URL sia accessibile pubblicamente, restituisca gli header corretti e che il file sia valido.
photo_pull_faileduser-errorImpossibile recuperare la foto dall'URL. Controlla che l'URL della foto sia accessibile.
Soluzione:
TikTok non è riuscito a scaricare la tua immagine. Verifica che l'URL sia accessibile pubblicamente e restituisca l'header content-type corretto (image/jpeg o image/png).
invalid_file_uploaduser-errorFormato file non valido o specifiche non soddisfatte.
Soluzione:
Il tuo file non soddisfa i requisiti di TikTok. Verifica che sia un file video/immagine valido in un formato supportato e che soddisfi tutte le specifiche.
#Limite di frequenza
rate_limit_exceededretryLimite di frequenza TikTok superato. Riprova tra qualche momento.
Soluzione:
Hai fatto troppe richieste troppo rapidamente. Attendi qualche minuto prima di riprovare. Il sistema riproverà automaticamente per te.
too many requestsretryLimite di frequenza TikTok superato. Riprova tra qualche momento.
Soluzione:
TikTok sta limitando le tue richieste. Riduci la frequenza delle chiamate API e implementa il backoff esponenziale nella tua logica di ripetizione.
#Stato app
unaudited_client_can_only_post_to_private_accountsuser-errorLa tua app è in modalità sviluppo e può pubblicare solo privatamente. Invia per la revisione di TikTok per la pubblicazione pubblica.
Soluzione:
La tua app TikTok non è approvata per la produzione. Invia la tua app per il processo di revisione di TikTok per abilitare le capacità di pubblicazione pubblica.
url_ownership_unverifieduser-errorProprietà URL non verificata, verifica la proprietà del dominio.
Soluzione:
Devi verificare la proprietà di eventuali URL esterni nei tuoi post. Aggiungi il codice di verifica al tuo dominio o usa la console sviluppatori TikTok per verificare.
privacy_level_option_mismatchuser-errorMancata corrispondenza del livello di privacy, controlla le impostazioni sulla privacy.
Soluzione:
Il livello di privacy che hai specificato non corrisponde alle capacità della tua app o alle impostazioni dell'account. Rivedi le autorizzazioni della tua app e le impostazioni sulla privacy.
#Server
internalretryThere is a problem with TikTok servers, please try again later.
Soluzione:
TikTok is experiencing server issues. This is temporary. Wait a few minutes and try again. The system will automatically retry.
invalid_paramsuser-errorInvalid request parameters, please check content format.
Soluzione:
One or more parameters in your request are invalid. Review the TikTok API documentation and ensure all required fields are present and correctly formatted.
Migliori Pratiche
Gestione degli Errori
- →Implementare strategie di elusione rilevamento spam
- →Validare formato e specifiche video prima del caricamento
- →Gestire limiti di frequenza con backoff esponenziale
- →Inviare app per approvazione produzione
Suggerimenti per la Prevenzione
- →Usare formato MP4/WebM, minimo 720p, 23-60 fps
- →Mantenere video da 3 secondi a 10 minuti
- →Evitare contenuto ripetitivo o promozionale
- →Verificare proprietà dominio per URL esterni
Hai Bisogno di Aiuto per TikTok l'Integrazione?
La nostra API gestisce automaticamente gli scenari di errore con logica di riprova intelligente e registrazione dettagliata.