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 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}