links

POST `/v1/content/posts/generate`

Write article drafts with the model.

Authentification

Envoyez une clé d'API en tant que jeton du porteur (bearer token). Cet endpoint n'indique pas de permission spécifique dans la spécification, attribuez donc à votre clé le minimum requis et vérifiez la réponse plutôt que de faire des suppositions.

Cet endpoint ne prend aucun identifiant d'organisation. Votre clé identifie déjà l'organisation à laquelle elle appartient, et la réponse y est limitée.

Essayer

Remplacez tout ce qui se trouve entre crochets par vos propres valeurs, et le espace réservé à la clé par une clé de votre tableau de bord.

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

Connecté ? La console d'API de votre tableau de bord saisit votre véritable ID d'organisation ainsi que votre propre clé, et exécute la requête sur l'API de production afin que vous puissiez voir la réponse réelle. Ouvrir ce point de terminaison dans la console API

Détails

Turns a brief into DRAFT posts in the organisation's own content library, with the customer's anchors placed inside them. ⛔ It never schedules and never publishes — the drafts sit in the library until somebody reads them and creates a placement, which is the same line the hand-written path already draws. Gated on `links.edit`, the same key as writing a post by hand, because that is what this is. Every call is metered on the caller's own organisation — BYO key, then credits, then the included allowance — and is refused with a sentence naming what would clear it if none of the three can pay. ⛔ Anchors are placed VERBATIM and verified after generation. Any the model altered or dropped are named in the draft's `notes`, which the customer reads before scheduling — the platform never silently re-prompts (it would spend their money again) and never silently accepts (it would place a campaign they did not ask for).

Corps de la requête

Nom	Type	Obligatoire	Qu'est-ce que c'est
`brief`	`string`	Oui	What the article should be about, in the language you want it written in. A tighter brief produces better articles than a longer one.
`count`	`integer`	Non	How many articles to write. ⛔ Capped at 10: more than that from one brief produces near-identical copy across a network, which is the footprint the Footprint-Free line exists to…
`anchors`	`object[]`	Non	The links to place, each exactly once per article, using the given text verbatim. More than five in one article is a spam signal.

Réponse

Nom	Type	Obligatoire	Qu'est-ce que c'est
`items`	`ContentPost[]`	Oui	—

Erreurs que cet point de terminaison peut renvoyer

401 · 403 · 422

POST /v1/content/posts/generate