syndication

POST `/v1/syndication/posts/{postId}/{action}`

Approve, reject or retry one channel's post.

تصدیق‌هویت

د بیارر ټوکن په توګه یو API کي وسپارئ. دا پای ټکی په مشخصاتو کې کوم ځانګړی اجازه لیک نه بیانوي، نو خپل کیلي ته لږترلږه هغه څه ورکړئ چې ورته اړتیا لري او د فرض کولو پر ځای ځواب وپلټئ.

دا پای نقطه د سازمان هېڅ آی ډي نه اخلي. ستاسو کیلي مخکې تر مخکې هغه سازمان په ګوته کوي چې پورې اړه لري، او ځواب ورته محدود دی.

هڅه وکړئ

د انګلیسي په زاوي پنسونو کې هرڅه د خپلو ارزښتونو سره بدل کړئ، او د کلي ځای لرونکی ستاسو د ډشبورډ د کلي سره.

curl -X POST https://api.zinndigital.com/v1/syndication/posts/{postId}/{action} \
  -H "Authorization: Bearer zdk_live_…"

ننوتي یاست؟ ستاسو په ډشبورډ کې د API کنسول ستاسو د اصلي سازمان ID او ستاسو خپله کیلي ډکوي، او غوښتنه د ژوندی API په وړاندې پرمخ وړي ترڅو تاسو وکولی شئ اصلي ځواب وګورئ. دا پای ټکی (endpoint) د API په کنسول کې پرانیزئ

تفصیلات

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

پارامترونه

نوم	ډول	اړین	دا څه شی دی
`postId (path)`	`string`	هو	—
`action (path)`	`string<approve, reject, retry>`	هو	`approve` clears a held post for sending, `reject` marks it `skipped` (nothing went wrong — the customer said no), `retry` re-queues a failed one.

ځواب

نوم	ډول	اړین	دا څه شی دی
`id`	`string`	هو	—
`channel`	`string`	هو	—
`connection_id`	`string`	هو	—
`connection_label`	`string`	هو	—
`status`	`string<drafting, awaiting_approval, queued, posted, failed, needs_reconnect, skipped>`	هو	⛔⛔ `needs_reconnect` is NOT `failed`. `skipped` means the customer said no or the connection was removed — nothing went wrong.
`text`	`string`	هو	—
`remote_url`	`string`	هو	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[][]`	هو	`[[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`	هو	A machine code, never a sentence.
`cost_micros`	`integer`	هو	What this post cost us, in USD micros. One line per channel per post.
`character_limit`	`integer`	هو	—
`posted_at`	`string`	هو	—

تېروتنې چې دا پای ټکی یې بیرته راګرځولی شي

401 · 403 · 404

POST /v1/syndication/posts/{postId}/{action}