links

POST /v1/content/posts

Write a new post.

Alle links Endpunkte

Authentifizierung

Senden Sie einen API-Schlüssel als Bearer-Token. Dieser Endpunkt gibt in der Spezifikation keine spezifische Berechtigung an. Versehen Sie Ihren Schlüssel daher mit den minimal erforderlichen Rechten und prüfen Sie die Antwort, anstatt Annahmen zu treffen.

Dieser Endpunkt erfordert keine Organisations-ID. Ihr Schlüssel identifiziert bereits die zugehörige Organisation, und die Antwort ist entsprechend eingeschränkt.

Ausprobieren

Ersetzen Sie alles in spitzen Klammern durch Ihre eigenen Werte und den Platzhalter für den Schlüssel durch einen Schlüssel aus Ihrem Dashboard.

curl -X POST https://api.zinndigital.com/v1/content/posts \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "title": <string> }'

Angemeldet? Die API-Konsole in Ihrem Dashboard trägt automatisch Ihre echte Organisations-ID sowie Ihren eigenen Schlüssel ein und führt die Anfrage gegen die Live-API aus, sodass Sie die tatsächliche Antwort sehen können. Öffnen Sie diesen Endpunkt in der API-Konsole

Details

Creates a content item. It publishes nowhere until it is given a placement — see `createPostPlacement`. Gated on `links.edit`, the same key the bulk editor uses, because this content is destined for the customer's published pages.

Anfragekörper

NameTypErforderlichWas es ist
titlestringJa
body_htmlstringNein
notesstringNein

Antwort

NameTypErforderlichWas es ist
idstringJa
titlestringJa
body_htmlstringJaThe post body as HTML, exactly as the customer wrote it. The `<a>` tags in it are the anchors; the platform never rewrites them, on the way in or the way out.
notesstringJaThe customer's own notes — V1's `Post.notes`. Never published.
statusstring<draft, ready>Ja
placement_countintegerJaSites this post is scheduled or live on.
published_countintegerJa
created_atstringJa
updated_atstringJa

Fehler, die dieser Endpunkt zurückgeben kann

401 · 403 · 422