Pinterest API-FehlerreferenzVollständiger Leitfaden zur Fehlerbehebung mit Lösungen
Umfassende Referenz für Pinterest API-Fehler. Finden Sie Lösungen und beheben Sie häufige Integrationsprobleme.
Fehlerkategorien
Video
2 errors
Authentifizierung
2 errors
Ratenlimit
2 errors
Medien
2 errors
Alle Fehlercodes
#Video
cover_image_urluser-errorBeim Hochladen eines Videos auf Pinterest müssen Sie auch ein Cover-Bild bereitstellen.
Lösung:
Pinterest benötigt ein Cover-Bild für alle Video-Pins. Geben Sie sowohl cover_image_url als auch cover_image_content_type beim Hochladen von Videos an. Das Cover-Bild sollte JPG oder PNG sein.
cover_image_content_typeuser-errorBeim Hochladen eines Videos auf Pinterest müssen Sie auch ein Cover-Bild bereitstellen.
Lösung:
Geben Sie den Content-Type des Cover-Bildes (image/jpeg oder image/png) zusammen mit cover_image_url an. Beide Felder sind für Video-Uploads erforderlich.
#Authentifizierung
unauthorizedrefresh-tokenPinterest-Zugriffstoken ist ungültig. Bitte verbinden Sie Ihr Pinterest-Konto erneut.
Lösung:
Ihr Pinterest-Zugriffstoken ist nicht mehr gültig. Dies kann nach Token-Ablauf oder wenn Sie den App-Zugriff widerrufen haben, geschehen. Verbinden Sie Ihr Konto in den Einstellungen erneut.
invalid tokenrefresh-tokenPinterest-Zugriffstoken ist ungültig. Bitte verbinden Sie Ihr Pinterest-Konto erneut.
Lösung:
Ihr Authentifizierungstoken ist fehlerhaft oder abgelaufen. Gehen Sie zu Ihren Kontoeinstellungen und verbinden Sie Ihr Pinterest-Konto erneut, um ein neues gültiges Token zu erhalten.
#Ratenlimit
429retryPinterest-Ratenlimit erreicht. Bitte versuchen Sie es später erneut.
Lösung:
Sie haben die Ratenlimits von Pinterest überschritten. Pinterest hat tägliche und stündliche Ratenlimits. Warten Sie, bis das Ratenlimit zurückgesetzt wird (normalerweise innerhalb einer Stunde), bevor Sie es erneut versuchen.
rate limitretryPinterest-Ratenlimit erreicht. Bitte versuchen Sie es später erneut.
Lösung:
Pinterest setzt Ratenlimits durch, um API-Missbrauch zu verhindern. Reduzieren Sie die Häufigkeit Ihrer Anfragen und implementieren Sie exponentielles Backoff in Ihrer Wiederholungslogik.
#Medien
invalid mediauser-errorMedienformat wird von Pinterest nicht unterstützt. Bitte verwenden Sie JPG, PNG für Bilder oder MP4 für Videos.
Lösung:
Pinterest unterstützt: Bilder (JPG, PNG), Videos (MP4, MOV). Konvertieren Sie Ihre Medien in eines dieser unterstützten Formate, bevor Sie sie hochladen.
unsupported formatuser-errorMedienformat wird von Pinterest nicht unterstützt. Bitte verwenden Sie JPG, PNG für Bilder oder MP4 für Videos.
Lösung:
Verwenden Sie unterstützte Formate - Bilder: JPG oder PNG. Videos: MP4 oder MOV mit H.264-Codec. Stellen Sie sicher, dass Ihre Dateien den technischen Spezifikationen von Pinterest entsprechen.
Beste Praktiken
Fehlerbehandlung
- →Stellen Sie immer ein Cover-Bild für Video-Uploads bereit
- →Implementieren Sie Ratenlimit-Behandlung und Backoff
- →Validieren Sie Medienformat vor dem Upload
- →Überwachen Sie den Pinterest API-Status
Präventions-Tipps
- →Fügen Sie cover_image_url für alle Videos hinzu
- →Verwenden Sie JPG/PNG für Bilder, MP4/MOV für Videos
- →Respektieren Sie Ratenlimits (stündlich und täglich)
- →Halten Sie Tokens frisch und sicher
Benötigen Sie Hilfe bei der Pinterest Integration?
Unsere API behandelt Fehlerszenarien automatisch mit intelligenter Wiederholungslogik und detaillierter Protokollierung.