links

POST /v1/content/posts/generate

Write article drafts with the model.

Todos os endpoints de links

Autenticação

Envie uma chave de API como um token bearer. Este endpoint não especifica uma permissão específica na documentação, portanto, conceda à sua chave o mínimo necessário e verifique a resposta em vez de assumir.

Este endpoint não requer um ID de organização. Sua chave já identifica a organização à qual pertence, e a resposta é delimitada a ela.

Experimente

Substitua qualquer item entre colchetes por seus próprios valores e o espaço reservado para a chave por uma chave do seu painel.

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

Conectado? O console da API no seu painel preenche o ID da sua organização real e a sua própria chave, e executa a requisição contra a API de produção para que você possa ver a resposta real. Abra este endpoint no console da API

Detalhes

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).

Corpo da requisição

NomeTipoObrigatórioO que é
briefstringSimWhat the article should be about, in the language you want it written in. A tighter brief produces better articles than a longer one.
countintegerNãoHow 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…
anchorsobject[]NãoThe links to place, each exactly once per article, using the given text verbatim. More than five in one article is a spam signal.

Resposta

NomeTipoObrigatórioO que é
itemsContentPost[]Sim

Erros que este endpoint pode retornar

401 · 403 · 422