Instagram API Error ReferenceGuida completa alla risoluzione dei problemi con soluzioni

Riferimento completo per gli errori dell'API Instagram Graph. Trova soluzioni per caricamenti multimediali, problemi di account aziendali, caroselli ed etichettatura prodotti.

32codici di errore
8categorie
Graph API v19.0

Categorie di Errori

Autenticazione

5 errors

Caricamento media

8 errors

Formato media

8 errors

Contenuto

3 errors

Carosello

1 error

Etichettatura prodotti

4 errors

Limitazione di frequenza

2 errors

Server

1 error

Tutti i Codici di Errore

#Autenticazione

REVOKED_ACCESS_TOKENrefresh-token

Il token di accesso Instagram è stato revocato. Riconnetti il tuo account Instagram.

Soluzione:

Il tuo token di accesso Instagram è stato revocato. Ciò accade quando rimuovi i permessi dell'app dalle impostazioni di Instagram. Vai nelle impostazioni del tuo account e riconnetti Instagram con tutti i permessi richiesti.

session has been invalidatedrefresh-token

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

Soluzione:

La tua sessione Instagram non è più valida. Ciò può accadere dopo un cambio di password o un controllo di sicurezza. Riconnetti il tuo account Instagram per stabilire una nuova sessione.

the user is not an instagram businessrefresh-token

Il tuo account Instagram deve essere un account aziendale. Convertilo in un account aziendale e riconnettilo.

Soluzione:

L'API Instagram richiede un account aziendale o creatore. Converti il tuo account: Vai su Impostazioni Instagram → Account → Passa all'account professionale → Scegli Aziendale.

2207050user-error

Il tuo account Instagram è stato limitato. Controlla lo stato del tuo account su Instagram.

Soluzione:

Instagram ha limitato il tuo account. Accedi direttamente a Instagram per vedere se ci sono avvisi o restrizioni. Potrebbe essere necessario verificare la tua identità o fare ricorso contro la restrizione.

Not enough permissions to postuser-error

Permessi insufficienti per pubblicare.

Soluzione:

L'app non ha i permessi richiesti. Durante la riconnessione, assicurati di concedere tutti i permessi, in particolare 'instagram_content_publish' e 'instagram_basic'.

#Caricamento media

2207003user-error

Timeout durante il download dei media, riprova.

Soluzione:

Instagram non è riuscito a scaricare i tuoi media dall'URL entro il periodo di timeout. Assicurati che l'URL dei media sia accessibile pubblicamente e che il server risponda rapidamente. Prova a ricaricare.

2207020user-error

Media scaduto, carica di nuovo.

Soluzione:

Il contenitore multimediale è scaduto prima della pubblicazione. I contenitori multimediali di Instagram scadono dopo 24 ore. Crea un nuovo contenitore multimediale e pubblicalo immediatamente.

2207032user-error

Impossibile creare media, riprova.

Soluzione:

Instagram non è riuscito a creare il contenitore multimediale. Potrebbe essere un problema temporaneo. Attendi un momento e riprova. Assicurati che i tuoi media soddisfino le specifiche di Instagram.

2207053user-error

Errore di caricamento sconosciuto, riprova.

Soluzione:

Si è verificato un errore sconosciuto durante il caricamento. Verifica che il tuo file multimediale sia valido e soddisfi i requisiti di Instagram. Prova a caricare un file diverso per isolare il problema.

2207052user-error

Recupero media non riuscito, riprova.

Soluzione:

Instagram non è riuscito a recuperare i tuoi media dall'URL fornito. Verifica che l'URL sia accessibile pubblicamente, restituisca l'header content-type corretto e che il file sia valido.

2207006user-error

Media non trovato, carica di nuovo.

Soluzione:

Il contenitore multimediale non è stato trovato. Potrebbe essere stato eliminato o scaduto. Crea un nuovo contenitore multimediale e riprova.

2207008user-error

Costruttore media scaduto, riprova.

Soluzione:

La sessione del costruttore multimediale è scaduta. Ciò accade se è trascorso troppo tempo tra la creazione del contenitore e la pubblicazione. Crea e pubblica in un unico flusso.

2207027user-error

Errore sconosciuto, riprova più tardi o contatta il supporto.

Soluzione:

Si è verificato un errore sconosciuto. Attendi qualche minuto e riprova. Se il problema persiste, contatta il supporto con tutti i dettagli dell'errore.

#Formato media

2207004user-error

L'immagine è troppo grande.

Soluzione:

Riduci le dimensioni del file immagine. Instagram ha una dimensione massima di 8 MB per le immagini. Usa uno strumento di compressione per ridurre le dimensioni del file mantenendo la qualità.

2207005user-error

Formato immagine non supportato.

Soluzione:

Instagram supporta solo i formati immagine JPG e PNG. Converti la tua immagine in uno di questi formati prima di caricarla.

2207009user-error

Rapporto d'aspetto non supportato (deve essere tra 4:5 e 1.91:1).

Soluzione:

Instagram richiede rapporti d'aspetto tra 4:5 (verticale) e 1.91:1 (orizzontale). Ritaglia o ridimensiona la tua immagine per rientrare in questi limiti.

36003user-error

Rapporto d'aspetto non supportato (deve essere tra 4:5 e 1.91:1).

Soluzione:

Il rapporto d'aspetto della tua immagine è al di fuori dell'intervallo consentito da Instagram. Usa 1:1 (quadrato), 4:5 (verticale) o 1.91:1 (orizzontale). Evita rapporti d'aspetto estremi.

36001user-error

Risoluzione immagine Instagram non valida max: 1920x1080px.

Soluzione:

Instagram limita la risoluzione dell'immagine a 1920x1080 pixel. Ridimensiona la tua immagine per rientrare in queste dimensioni.

2207026user-error

Formato video non supportato.

Soluzione:

Instagram supporta solo il formato video MP4 con codec H.264 e audio AAC. Converti il tuo video per soddisfare queste specifiche.

2207057user-error

Offset miniatura non valido per il video.

Soluzione:

L'offset della miniatura che hai specificato non è valido. Deve essere entro la durata del video. Usa un valore tra 0 e la lunghezza del video in millisecondi.

2207023user-error

Tipo di media sconosciuto.

Soluzione:

Instagram non è riuscito a determinare il tipo di media. Assicurati di specificare il parametro media_type corretto (IMAGE, VIDEO o CAROUSEL_ALBUM).

#Contenuto

2207010user-error

La didascalia è troppo lunga.

Soluzione:

Le didascalie di Instagram hanno una lunghezza massima di 2.200 caratteri. Accorcia la tua didascalia e riprova.

2207001user-error

Instagram ha rilevato che il tuo post è spam. Prova a modificare il contenuto.

Soluzione:

Il rilevamento spam di Instagram ha segnalato il tuo contenuto. Evita post ripetitivi, hashtag eccessivi o linguaggio spam. Attendi un po' e prova a pubblicare contenuti diversi.

2207051user-error

Instagram ha bloccato la tua richiesta.

Soluzione:

Instagram ha bloccato questa richiesta, probabilmente a causa del limite di frequenza o di attività sospette. Attendi 15-30 minuti prima di riprovare e riduci la frequenza di pubblicazione.

#Etichettatura prodotti

2207035user-error

Le posizioni dei tag prodotto non sono supportate per i video.

Soluzione:

Non puoi specificare le posizioni dei tag prodotto per i post video. Solo i post di immagini supportano i tag prodotto posizionati.

2207036user-error

Posizioni tag prodotto richieste per le foto.

Soluzione:

Quando tagghi i prodotti nelle foto, devi specificare le coordinate x e y per le posizioni dei tag. Fornisci i dati di posizione per tutti i tag prodotto.

2207037user-error

Validazione tag prodotto non riuscita.

Soluzione:

Uno o più tag prodotto non sono validi. Verifica che tutti gli ID prodotto esistano nel tuo catalogo e che le coordinate di posizione siano tra 0.0 e 1.0.

2207040user-error

Troppi tag prodotto.

Soluzione:

Instagram limita il numero di tag prodotto per post. Riduci il numero di prodotti che stai taggando (il massimo è tipicamente 5 prodotti per immagine).

#Limitazione di frequenza

Page request limit reacheduser-error

La pubblicazione della pagina per oggi è limitata, riprova domani.

Soluzione:

Hai raggiunto il limite di pubblicazione giornaliero di Instagram. Instagram consente 25 post al giorno. Attendi fino al giorno successivo per pubblicare più contenuti.

2207042user-error

Hai raggiunto il massimo di 25 post al giorno consentiti per il tuo account.

Soluzione:

Instagram applica un limite di 25 post al giorno. Attendi fino a domani per pubblicare più contenuti. Considera di programmare i tuoi post per distribuirli su più giorni.

#Server

An unknown error occurredretry

Instagram ha riscontrato un errore sconosciuto, riprovo...

Soluzione:

Instagram ha riscontrato un errore temporaneo. Il sistema riproverà automaticamente. Se continua a fallire, attendi qualche minuto prima di riprovare.

Migliori Pratiche

Gestione degli Errori

  • Implementare tentativi automatici per elaborazione media ed errori di servizio
  • Gestire scadenza contenitore media (limite 24 ore)
  • Validare specifiche media prima del caricamento
  • Monitorare stato e restrizioni account Instagram

Suggerimenti per la Prevenzione

  • Assicurarsi di avere account Business o Creator prima di connettere
  • Validare formato, dimensione e rapporto d'aspetto dei media
  • Creare e pubblicare contenitori media entro 24 ore
  • Rispettare limite di 25 post al giorno

Hai Bisogno di Aiuto per Instagram l'Integrazione?

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