links

GET /v1/content/runs/{runId}

One run, with every site's outcome.

Tutti gli endpoint links

Autenticazione

Invia una chiave API come bearer token. Questo endpoint non specifica un permesso specifico nella specifica, quindi assegna alla tua chiave i permessi minimi necessari e verifica la risposta invece di fare supposizioni.

Questo endpoint non richiede alcun ID organizzazione. La tua chiave identifica già l'organizzazione a cui appartiene e la risposta è limitata ad essa.

Provalo

Sostituisci qualsiasi elemento tra parentesi angolari con i tuoi valori e il segnaposto key con una chiave dalla tua dashboard.

curl -X GET https://api.zinndigital.com/v1/content/runs/{runId} \
  -H "Authorization: Bearer zdk_live_…"

Hai effettuato l'accesso? La console API nella tua dashboard inserisce il tuo ID organizzazione reale e la tua chiave personale, ed esegue la richiesta sull'API live in modo da poter vedere la risposta effettiva. Apri questo endpoint nella console API

Dettagli

The whole run screen in one call. Gated on `links.view`. 404 rather than 403 for a run in another tenant — a 403 would confirm the row exists.

Parametri

NomeTipoObbligatorioChe cos'è
runId (path)string

Risposta

NomeTipoObbligatorioChe cos'è
idstring
stateContentRunStateWhere a run got to. `partial` is a real, honest, terminal answer and not a euphemism: some sites published and some did not, nothing is left to try, and the failures can be resu…
publish_policyContentRunPublishPolicyHow far a run may go on its own. `draft_only` is the default and puts nothing live.
recipe_idstringNo
briefstring
categorystringNo
post_idstringNoThe article this run wrote. Written once and reused for every site, so a resumed run places the SAME copy rather than paying for a second generation.
attemptintegerWhich pass over the failures this is. 0 is the original run.
workflow_idstringNo
totalsContentRunTotals
reasonContentRunFailureReasonNo
providerstringNo
messagestringNoAn English sentence for the customer. Clients should render their own localised text from `reason` and fall back to this only for a code they do not know.
resumablebooleanWhether a resume would actually do anything. False on a paused run with nothing failed — do not offer the button when this is false.
started_atstringNo
finished_atstringNo
created_atstring
itemsContentRunItem[]

Errori che questo endpoint può restituire

401 · 403 · 404