Synup
Schlüssel erstellen
v1Ressourcen/Posts/deleteBeitrag zurückziehen und löschen

Beitrag zurückziehen und löschen

Entfernt den Beitrag von jeder Plattform, auf der er live war, und archiviert ihn dann: Der Datensatz bleibt erhalten, wird aber nicht mehr aufgelistet. Ein Beitrag, der nie live war (draft, scheduled, error), muss nirgends entfernt werden und wird sofort archiviert, wodurch auch sein Zeitplan aufgehoben wird. Schlägt das Entfernen auf einer Plattform fehl, wird der Beitrag nicht archiviert und die Antwort meldet die Fehler mit ok: false; bereits entfernte Plattformen bleiben entfernt, versuchen Sie es also erneut, um den Rest abzuschließen.

delete/api/v1/posts/{id}
posts:write
Query-Parameter
idstringerforderlich
Der zu löschende Beitrag.
Antwort
dataobjectoptional
idstringoptional
Eindeutige Kennung des Beitrags.
okbooleanoptional
Ob jede Plattformübermittlung erfolgreich zurückgezogen wurde.
deletednumberoptional
Anzahl der erfolgreich zurückgezogenen Plattformübermittlungen.
failedarray of objectoptional
Plattformübermittlungen, deren Rückzug fehlgeschlagen ist, falls vorhanden.
connectionIdstringoptional
ID der Verbindung, deren Rückzug fehlgeschlagen ist.
platformstringoptional
Die Plattform, für die diese Zeile steht.
errorstringoptional
Fehlermeldung, die beschreibt, warum der Rückzug fehlgeschlagen ist.
Fehler
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.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
delete/api/v1/posts/{id}
Ihr API-Schlüssel
id *
{
  "data": {
    "id": "cm_post_abc123",
    "ok": true,
    "deleted": 2,
    "failed": []
  }
}

Anleitungen, die diesen Endpunkt verwenden