Synup
Schlüssel erstellen
v1Ressourcen/Posts/postFehlgeschlagene Ziele eines Beitrags wiederherstellen

Fehlgeschlagene Ziele eines Beitrags wiederherstellen

Erstellt einen neuen Entwurf für die Ziele, auf denen ein Beitrag nicht veröffentlicht werden konnte, damit Sie ihn korrigieren und erneut senden können. Nutzen Sie dies für einen Beitrag mit dem Status partial (einige Ziele sind live, andere fehlgeschlagen) oder error (kein Ziel ist live). Der Entwurf übernimmt Inhalt und Medien des Originals und richtet sich nur an die fehlgeschlagenen Verbindungen. Es wird nichts veröffentlicht oder geplant: Bearbeiten Sie den Entwurf, falls das Netzwerk den Inhalt abgelehnt hat, und planen oder veröffentlichen Sie ihn dann wie jeden anderen Beitrag. Der Entwurf kann nur diese fehlgeschlagenen Ziele verwenden; eine weitere Verbindung hinzuzufügen wird mit 409 abgelehnt. Die Live-Ziele des ursprünglichen Beitrags bleiben unverändert. Die fehlgeschlagenen Ziele wechseln in den Entwurf und können im Original nicht mehr wiederholt werden, daher erscheint ein Beitrag mit partial danach als active. Ein erneuter Aufruf für denselben Beitrag liefert denselben Entwurf mit 201, statt einen zweiten zu erstellen. Wurde dieser Entwurf gelöscht, liefert der Aufruf 409 und es wird keine neue Wiederherstellung angelegt. Ein Ziel bleibt im Original, wenn sein Ergebnis unklar ist (das Netzwerk hat den Beitrag möglicherweise bereits), wenn bereits eine Wiederholung geplant ist oder wenn seine Plattform derzeit nicht angeboten wird. Erfüllt kein Ziel die Bedingungen, liefert der Aufruf 422. Serienbeiträge, Beiträge eines Mehrkunden-Beitrags und importierte Beiträge lassen sich hier nicht wiederherstellen. Der Benutzer des API-Schlüssels muss aktiv sein und Zugriff auf Social und auf den Kunden des Beitrags haben. Ist die Wiederherstellung für Ihren Workspace nicht verfügbar, gibt der Aufruf 404 zurück. Senden Sie keinen Request-Body.

post/api/v1/posts/{id}/recover-failed
posts:write
Query-Parameter
idstringerforderlich
Der Beitrag, dessen Veröffentlichung fehlgeschlagen ist, per id oder öffentlicher ID.
Antwort
dataobjectoptional
idstringoptional
Die ID des Wiederherstellungsentwurfs. Damit bearbeiten, planen oder veröffentlichen Sie den Entwurf.
publicIdstringoptional
Die öffentliche ID des Wiederherstellungsentwurfs oder null, falls keine vorhanden ist.
statusstringoptional
Der Status des Wiederherstellungsentwurfs: draft bei einer neuen Wiederherstellung. Ein erneuter Aufruf liefert den aktuellen Status des vorhandenen Entwurfs, zum Beispiel scheduled, sobald ihn jemand geplant hat.
connectionIdsarray of stringoptional
Die Verbindungen, auf denen der Entwurf veröffentlicht wird: die fehlgeschlagenen Ziele des ursprünglichen Beitrags.
Fehler
400Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.
403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.
404Die Ressource wurde nicht gefunden oder gehört nicht zu Ihrer Agentur.
409Der Beitrag hat sich während der Erstellung des Entwurfs geändert, eine Wiederherstellung für diesen Beitrag existiert bereits oder wurde gelöscht, oder der Beitrag gehört zu einem Mehrkunden-Beitrag. Laden Sie den Beitrag neu und versuchen Sie es erneut.
422Der Beitrag kann nicht wiederhergestellt werden: Sein Status ist nicht partial oder error, er gehört zu einer Serie, kein fehlgeschlagenes Ziel erfüllt die Bedingungen, oder die Verbindung eines fehlgeschlagenen Ziels ist getrennt oder wird nicht angeboten.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
500Der Wiederherstellungsentwurf konnte nicht erstellt werden. Laden Sie den Beitrag neu und versuchen Sie es erneut.
503Die Beitragsaktion konnte nicht abgeschlossen werden.
post/api/v1/posts/{id}/recover-failed
Ihr API-Schlüssel
id *
{}

Anleitungen, die diese Ressource verwenden