Synupv1
Schlüssel erstellen
v1Ressourcen/Post Ideas/postBeitragsidee veröffentlichen

Beitragsidee veröffentlichen

Veröffentlicht eine Beitragsidee als echten Beitrag und übermittelt sie an ihre Zielplattformen. Sofern nicht scheduledFor oder draft gesetzt ist, wird dabei sofort echter Inhalt live geschaltet. id akzeptiert entweder die eigene id der Idee oder die externalId, mit der sie erstellt wurde.

post/api/v1/post-ideas/{id}/publish
posts:write
Query-Parameter
idstringerforderlich
Die zu veröffentlichende Beitragsidee — ihre id oder externalId.
Anfragetext
scheduledForstringoptional
Zu diesem zukünftigen ISO-8601-Zeitstempel veröffentlichen, anstatt sofort.
draftbooleanoptional
Als Entwurfsbeitrag speichern, statt sofort zu veröffentlichen.
Antwort
dataobjectoptional
Eine angeforderte Plattform ohne aktive Verbindung, oder ein Feld, das die Idee vor der Veröffentlichung benötigt, lässt diesen Aufruf nie fehlschlagen — die Idee wird stattdessen als Entwurfsbeitrag gespeichert. Wird dies erneut für eine Idee aufgerufen, die bereits einen Beitrag hat, liefert es alreadyPublished: true, anstatt einen zweiten zu erstellen.
postIdstringoptional
ID des Beitrags, als der diese Idee veröffentlicht wurde, oder null, falls die Veröffentlichung nicht abgeschlossen wurde.
statusstringoptional
Ideenstatus: draft, published oder archived.
ideaIdstringoptional
ID der Beitragsidee, die veröffentlicht wurde.
alreadyPublishedbooleanoptional
Ob diese Idee bereits durch einen früheren Aufruf einen Beitrag hatte — wenn true, wurde nichts Neues veröffentlicht.
missingFieldsarray of stringoptional
Felder, die vor der Veröffentlichung des daraus entstehenden Beitrags noch benötigt werden, falls vorhanden.
missingPlatformsarray of stringoptional
Angeforderte Plattformen ohne aktive Verbindung, falls vorhanden.
scopestring (location | client)optional
Ob die Verbindungs-/Feld-Lücke auf Standort- oder Kundenebene gilt.
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.
422Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
post/api/v1/post-ideas/{id}/publish
Ihr API-Schlüssel
id *
Anfragetext
{
  "data": {
    "postId": "cm_post_xyz789",
    "status": "scheduled",
    "ideaId": "cm_idea_abc123"
  }
}