Référence des erreurs de l'API PinterestGuide complet de dépannage avec solutions

Référence complète pour les erreurs de l'API Pinterest. Trouvez des solutions et résolvez les problèmes d'intégration courants.

8 codes d'erreur
4 catégories
API v5

Catégories d'Erreurs

Vidéo

2 errors

Authentification

2 errors

Limite de débit

2 errors

Médias

2 errors

Tous les Codes d'Erreur

#Vidéo

cover_image_urluser-error

Lors du téléchargement d'une vidéo sur Pinterest, vous devez également fournir une image de couverture.

Solution :

Pinterest nécessite une image de couverture pour toutes les épingles vidéo. Fournissez à la fois cover_image_url et cover_image_content_type lors du téléchargement de vidéos. L'image de couverture doit être au format JPG ou PNG.

cover_image_content_typeuser-error

Lors du téléchargement d'une vidéo sur Pinterest, vous devez également fournir une image de couverture.

Solution :

Spécifiez le type de contenu de l'image de couverture (image/jpeg ou image/png) avec cover_image_url. Les deux champs sont requis pour les téléchargements de vidéos.

#Authentification

unauthorizedrefresh-token

Le jeton d'accès Pinterest est invalide. Veuillez reconnecter votre compte Pinterest.

Solution :

Votre jeton d'accès Pinterest n'est plus valide. Cela peut se produire après l'expiration du jeton ou si vous avez révoqué l'accès de l'application. Reconnectez votre compte dans les paramètres.

invalid tokenrefresh-token

Le jeton d'accès Pinterest est invalide. Veuillez reconnecter votre compte Pinterest.

Solution :

Votre jeton d'authentification est malformé ou expiré. Allez dans les paramètres de votre compte et reconnectez votre compte Pinterest pour obtenir un nouveau jeton valide.

#Limite de débit

429retry

Limite de débit Pinterest atteinte. Veuillez réessayer plus tard.

Solution :

Vous avez dépassé les limites de débit de Pinterest. Pinterest a des limites de débit quotidiennes et horaires. Attendez que la limite se réinitialise (généralement dans l'heure) avant de réessayer.

rate limitretry

Limite de débit Pinterest atteinte. Veuillez réessayer plus tard.

Solution :

Pinterest applique des limites de débit pour empêcher les abus de l'API. Réduisez la fréquence de vos requêtes et implémentez un backoff exponentiel dans votre logique de réessai.

#Médias

invalid mediauser-error

Format média non pris en charge par Pinterest. Veuillez utiliser JPG, PNG pour les images ou MP4 pour les vidéos.

Solution :

Pinterest prend en charge : Images (JPG, PNG), Vidéos (MP4, MOV). Convertissez vos médias dans l'un de ces formats pris en charge avant de les télécharger.

unsupported formatuser-error

Format média non pris en charge par Pinterest. Veuillez utiliser JPG, PNG pour les images ou MP4 pour les vidéos.

Solution :

Utilisez des formats pris en charge - Images : JPG ou PNG. Vidéos : MP4 ou MOV avec codec H.264. Assurez-vous que vos fichiers répondent aux spécifications techniques de Pinterest.

Meilleures Pratiques

Gestion des Erreurs

  • Toujours fournir une image de couverture pour les téléchargements de vidéos
  • Implémenter la gestion des limites de débit et le recul
  • Valider le format des médias avant le téléchargement
  • Surveiller l'état de l'API Pinterest

Conseils de Prévention

  • Inclure cover_image_url pour toutes les vidéos
  • Utiliser JPG/PNG pour les images, MP4/MOV pour les vidéos
  • Respecter les limites de débit (horaires et quotidiennes)
  • Garder les tokens frais et sécurisés

Besoin d'Aide pour Pinterest l'Intégration?

Notre API gère automatiquement les scénarios d'erreur avec une logique de nouvelle tentative intelligente et une journalisation détaillée.