syndication
POST /v1/syndication/posts/{postId}/{action}
Approve, reject or retry one channel's post.
Authenticatie
Stuur een API-sleutel mee als bearer token. Dit eindpunt vermeldt geen specifieke toestemming in de specificatie, dus geef uw sleutel de minimale rechten die nodig zijn en controleer het antwoord in plaats van zomaar wat aan te nemen.
Dit eindpunt vereist geen organisatie-id. Uw sleutel identificeert al de organisatie waartoe deze behoort, en het antwoord is hierop afgestemd.
Probeer het
Vervang alles tussen punthaakjes door uw eigen waarden en de sleutelplaatsvervanger door een sleutel uit uw dashboard.
curl -X POST https://api.zinndigital.com/v1/syndication/posts/{postId}/{action} \
-H "Authorization: Bearer zdk_live_…"Ingelogd? De API-console in je dashboard vult je echte organisatie-id en je eigen sleutel in, en voert het verzoek uit tegen de live API zodat je de daadwerkelijke respons kunt zien. Open dit eindpunt in de API-console
Details
Approving queues the post for the next sweep; rejecting settles it `skipped` because nothing went wrong; retrying re-queues a `failed` or `needs_reconnect` post — reconnect the account first, or it will settle the same way again. Gated on `syndication.manage`.
Parameters
| Naam | Type | Verplicht | Wat dit is |
|---|---|---|---|
postId (path) | string | Ja | — |
action (path) | string<approve, reject, retry> | Ja | `approve` clears a held post for sending, `reject` marks it `skipped` (nothing went wrong — the customer said no), `retry` re-queues a failed one. |
Reactie
| Naam | Type | Verplicht | Wat dit is |
|---|---|---|---|
id | string | Ja | — |
channel | string | Ja | — |
connection_id | string | Ja | — |
connection_label | string | Ja | — |
status | string<drafting, awaiting_approval, queued, posted, failed, needs_reconnect, skipped> | Ja | ⛔⛔ `needs_reconnect` is NOT `failed`. `skipped` means the customer said no or the connection was removed — nothing went wrong. |
text | string | Ja | — |
remote_url | string | Ja | The live post, read back from the channel where it returns one. ⛔ Empty where the vendor gives us nothing to build a URL from (a Slack incoming webhook answers the literal strin… |
dropped | string[][] | Ja | `[[field, reason], …]` — what this channel could not carry, and WHY. The reason travels: "no image endpoint" and "the upload was refused" are different problems with different n… |
error | string | Ja | A machine code, never a sentence. |
cost_micros | integer | Ja | What this post cost us, in USD micros. One line per channel per post. |
character_limit | integer | Ja | — |
posted_at | string | Ja | — |
Fouten die dit eindpunt kan retourneren
401 · 403 · 404