v1Ressourcen/Posts/deleteBeitrag zurückziehen und löschen

Beitrag zurückziehen und löschen

Zieht einen Beitrag von jeder Plattform zurück, an die er übermittelt wurde — eine echte, sofortige Aktion, die nicht rückgängig gemacht werden kann. Erst wenn der Rückzug auf jeder Plattform erfolgreich war, verschwindet der Beitrag auch aus dieser API; schlägt eine Plattform fehl, wird nichts archiviert und der Beitrag bleibt sichtbar, damit der Fehler wiederholt werden kann. Diese API löscht den Beitragsdatensatz niemals dauerhaft.

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": []
  }
}