syndication

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

Approve, reject or retry one channel's post.

توثيقِ شناخت

ایک API کلید بطور بیر ٹوکن (bearer token) ارسال کریں۔ یہ اینڈ پوائنٹ اسپیسیفیکیشن میں کسی مخصوص اجازت کا ذکر نہیں کرتا، اس لیے فرض کرنے کے بجائے اپنی کلید کو کم از کم درکار اجازت دیں اور رسپانس چیک کریں۔

یہ اینڈ پوائنٹ کوئی آرگنائزیشن آئی ڈی نہیں لیتا۔ آپ کی کلید پہلے ہی اس آرگنائزیشن کی شناخت کرتی ہے جس سے یہ تعلق رکھتی ہے، اور اس کا جواب اسی کے مطابق محدود ہوتا ہے۔

آزمائیں

کوئی بھی چیز جو زاویہ دار قوسین میں ہو اسے اپنی اقدار سے بدلیں، اور کلیدی پلیس ہولڈر کو اپنے ڈیش بورڈ کی کسی کلید سے بدلیں۔

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

لاگ ان ہیں؟ آپ کے ڈیش بورڈ میں موجود API کنسول آپ کی حقیقی تنظیم کی آئی ڈی اور آپ کی اپنی کلید خود بخود پُر کر دیتا ہے، اور لائیو API پر درخواست چلاتا ہے تاکہ آپ اصل ردعمل دیکھ سکیں۔ اس اینڈ پوائنٹ کو 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}