syndication

GET /v1/syndication/runs/{runId}

One article's fan-out.

Alle syndication 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 GET https://api.zinndigital.com/v1/syndication/runs/{runId} \
  -H "Authorization: Bearer zdk_live_…"

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

The run and one post per channel, each with its own status, what it dropped and why, and what it cost. Gated on `syndication.view`.

Parameter

NameTypErforderlichWas es ist
runId (path)stringJa

Antwort

NameTypErforderlichWas es ist
idstringJa
placement_idstringJa
post_titlestringJa
article_urlstringJaThe article's REAL live URL, read back from the destination when it published. ⛔ Never a composed URL — the permalink structure belongs to the customer.
statusstring<pending, holding, complete>Ja⛔ `complete` means every channel SETTLED, not that every channel succeeded.
postsSyndicationPost[]Ja
created_atstringJa

Fehler, die dieser Endpunkt zurückgeben kann

401 · 403 · 404