syndication

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

Approve, reject or retry one channel's post.

احراز هویت

یک کلید API را به عنوان یک توکن برbearer ارسال کنید. این نقطه پایانی مجوز خاصی را در مشخصات خود ذکر نمی‌کند، بنابراین به جای فرض کردن، حداقل نیازهای کلید خود را بدهید و پاسخ را بررسی کنید.

این نقطه پایانی هیچ شناسه سازمانی را دریافت نمی‌کند. کلید شما در حال حاضر سازمان مربوطه را مشخص می‌کند و پاسخ در همان محدوده ارائه می‌شود.

امتحان کنید

هر چیزی را که داخل براکت‌های زاویه‌دار قرار دارد با مقادیر خودتان جایگزین کنید، و نگهدارنده کلید را با کلیدی از داشبورد خود جایگزین نمایید.

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 string…
`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…
`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}