Riferimento errori API PinterestGuida completa alla risoluzione dei problemi con soluzioni
Riferimento completo per gli errori dell'API Pinterest. Trova soluzioni e risolvi problemi comuni di integrazione.
Categorie di Errori
Video
2 errors
Autenticazione
2 errors
Limite di frequenza
2 errors
Media
2 errors
Tutti i Codici di Errore
#Video
cover_image_urluser-errorQuando carichi un video su Pinterest, devi anche fornire un'immagine di copertina.
Soluzione:
Pinterest richiede un'immagine di copertina per tutti i pin video. Fornisci sia cover_image_url che cover_image_content_type quando carichi video. L'immagine di copertina deve essere JPG o PNG.
cover_image_content_typeuser-errorQuando carichi un video su Pinterest, devi anche fornire un'immagine di copertina.
Soluzione:
Specifica il tipo di contenuto dell'immagine di copertina (image/jpeg o image/png) insieme a cover_image_url. Entrambi i campi sono obbligatori per i caricamenti video.
#Autenticazione
unauthorizedrefresh-tokenIl token di accesso Pinterest non è valido. Riconnetti il tuo account Pinterest.
Soluzione:
Il tuo token di accesso Pinterest non è più valido. Ciò può accadere dopo la scadenza del token o se hai revocato l'accesso all'app. Riconnetti il tuo account nelle impostazioni.
invalid tokenrefresh-tokenIl token di accesso Pinterest non è valido. Riconnetti il tuo account Pinterest.
Soluzione:
Il tuo token di autenticazione è malformato o scaduto. Vai nelle impostazioni del tuo account e riconnetti il tuo account Pinterest per ottenere un nuovo token valido.
#Limite di frequenza
429retryLimite di frequenza Pinterest raggiunto. Riprova più tardi.
Soluzione:
Hai superato i limiti di frequenza di Pinterest. Pinterest ha limiti di frequenza giornalieri e orari. Attendi che il limite venga reimpostato (tipicamente entro un'ora) prima di riprovare.
rate limitretryLimite di frequenza Pinterest raggiunto. Riprova più tardi.
Soluzione:
Pinterest applica limiti di frequenza per prevenire abusi dell'API. Riduci la frequenza delle tue richieste e implementa il backoff esponenziale nella tua logica di ripetizione.
#Media
invalid mediauser-errorFormato media non supportato da Pinterest. Usa JPG, PNG per le immagini o MP4 per i video.
Soluzione:
Pinterest supporta: Immagini (JPG, PNG), Video (MP4, MOV). Converti i tuoi media in uno di questi formati supportati prima di caricarli.
unsupported formatuser-errorFormato media non supportato da Pinterest. Usa JPG, PNG per le immagini o MP4 per i video.
Soluzione:
Usa formati supportati - Immagini: JPG o PNG. Video: MP4 o MOV con codec H.264. Assicurati che i tuoi file soddisfino le specifiche tecniche di Pinterest.
Migliori Pratiche
Gestione degli Errori
- →Fornire sempre immagine di copertina per caricamenti video
- →Implementare gestione limiti di frequenza e backoff
- →Validare formato media prima del caricamento
- →Monitorare stato API Pinterest
Suggerimenti per la Prevenzione
- →Includere cover_image_url per tutti i video
- →Usare JPG/PNG per immagini, MP4/MOV per video
- →Rispettare limiti di frequenza (orari e giornalieri)
- →Mantenere token aggiornati e sicuri
Hai Bisogno di Aiuto per Pinterest l'Integrazione?
La nostra API gestisce automaticamente gli scenari di errore con logica di riprova intelligente e registrazione dettagliata.