Synupv1
Schlüssel erstellen
v1Ressourcen/Post Ideas/postBeitragsidee erstellen

Beitragsidee erstellen

Erstellt eine Entwurfs-Beitragsidee, die auf Prüfung wartet oder veröffentlichungsbereit ist (oder aktualisiert sie, falls externalId wiederholt wird).

post/api/v1/post-ideas
ideas:write
Anfragetext
locationIdstringoptional
Der Standort, für den diese Idee gedacht ist, oder auslassen für eine markenweite Idee.
clientIdstringoptional
Der Kunde, für den diese Idee gedacht ist (markenweite Ideen).
titlestringerforderlich
Der Titel der Idee. Bei der Erstellung erforderlich.
contentstringoptional
Der Text/Inhalt der Idee.
externalIdstringerforderlich
Eine von Ihnen kontrollierte, stabile ID — ein erneuter Erstellungsversuch mit derselben externalId aktualisiert die bestehende Idee, statt sie zu duplizieren. Bei der Erstellung erforderlich.
originstring (channel | routine | os_button)erforderlich
Woher diese Idee stammt: channel, routine oder os_button. Bei der Erstellung erforderlich.
typestring (announcement | offer | tip | showcase | story | event)optional
Ideentyp.
bucketstring (idea | holiday | calendar | series)optional
In welchem Raster-Bucket die Idee liegt.
platformsarray of stringoptional
Plattformen, für die diese Idee vorgesehen ist.
imageUrlstringoptional
URL eines an die Idee anzuhängenden Bildes.
imagePromptstringoptional
Der Prompt, mit dem das Bild der Idee generiert wurde.
seriesIdstringoptional
ID der Content-Serie, an die diese Idee angehängt werden soll.
scheduledDatestringoptional
Geplantes Veröffentlichungsdatum (YYYY-MM-DD).
scheduledTimestringoptional
Geplante Veröffentlichungszeit.
generationJobIdstringoptional
ID des KI-Generierungsjobs, der diese Idee erzeugt hat, falls vorhanden.
Antwort
dataobjectoptional
idstringoptional
Eindeutige Kennung der Beitragsidee.
createdbooleanoptional
Ob dieser Aufruf eine neue Idee erstellt hat (false, wenn bereits eine Idee mit dieser externalId existierte und stattdessen aktualisiert wurde).
reviewStatusstringoptional
Genehmigungsgate: null (kein Gate), pending, approved oder rejected.
statusstringoptional
Ideenstatus: draft, published oder archived.
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.
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
Ihr API-Schlüssel
Anfragetext*
{
  "data": {
    "id": "cm_idea_abc123",
    "created": true,
    "reviewStatus": null,
    "status": "draft"
  }
}