Riferimento errori API ThreadsGuida completa alla risoluzione dei problemi con soluzioni

Riferimento completo per gli errori dell'API Threads. Trova soluzioni e risolvi problemi comuni di integrazione.

7 codici di errore
3 categorie
Graph API

Categorie di Errori

Autenticazione

3 errors

Media

1 error

Video

3 errors

Tutti i Codici di Errore

#Autenticazione

revoked_access_tokenrefresh-token

Il token di accesso Threads non è valido o è stato revocato. Riconnetti il tuo account Threads.

Soluzione:

Il tuo token di accesso Threads è stato revocato. Ciò accade quando rimuovi i permessi dell'app o la sicurezza di Instagram rileva attività sospette. Riconnetti il tuo account.

token is invalidrefresh-token

Il token di accesso Threads non è valido o è stato revocato. Riconnetti il tuo account Threads.

Soluzione:

Il tuo token non è più valido. I token Threads sono legati agli account Instagram. Riconnetti il tuo account Threads tramite l'account aziendale Instagram.

session has been invalidatedrefresh-token

La tua sessione Threads è scaduta. Riconnetti il tuo account Threads.

Soluzione:

La tua sessione Threads è scaduta. Ciò può accadere dopo modifiche alla password o controlli di sicurezza. Riconnetti il tuo account Threads per stabilire una nuova sessione.

#Media

media processingretry

Threads sta ancora elaborando i tuoi media. Riprovando...

Soluzione:

Threads sta ancora elaborando i tuoi media caricati. Questo è normale e il sistema riproverà automaticamente. I video di grandi dimensioni potrebbero richiedere più tempo per l'elaborazione.

#Video

video formatuser-error

Formato video non supportato. Assicurati che il video sia in formato MP4 H.264/AAC.

Soluzione:

Threads richiede video MP4 con codec H.264 e audio AAC. Converti il tuo video in questo formato utilizzando strumenti come FFmpeg o HandBrake.

video codecuser-error

Formato video non supportato. Assicurati che il video sia in formato MP4 H.264/AAC.

Soluzione:

Codec video non supportato. Usa i codec H.264 (video) e AAC (audio). Evita di usare HEVC/H.265 o altri codec moderni che Threads non supporta ancora.

duration exceeduser-error

La durata del video supera il limite di Threads (max 5 minuti).

Soluzione:

I video di Threads devono durare 5 minuti o meno. Taglia il tuo video per rientrare in questo limite. Considera di dividere i contenuti più lunghi in più post.

Migliori Pratiche

Gestione degli Errori

  • Gestire automaticamente ritardi elaborazione media
  • Validare formato video prima del caricamento
  • Monitorare scadenza token
  • Implementare logica di nuovo tentativo per elaborazione media

Suggerimenti per la Prevenzione

  • Usare formato MP4 H.264/AAC per video
  • Mantenere video sotto 5 minuti
  • Riconnettere account dopo modifiche password Instagram
  • Attendere completamento elaborazione media

Hai Bisogno di Aiuto per Threads l'Integrazione?

La nostra API gestisce automaticamente gli scenari di errore con logica di riprova intelligente e registrazione dettagliata.