syndication
POST /v1/syndication/posts/{postId}/{action}
Approve, reject or retry one channel's post.
Autentifikatsiya
API kalitini bearer token sifatida yuboring. Ushbu yakuniy nuqta spetsifikatsiyada ma'lum bir ruxsatni ko'rsatmaydi, shuning uchun kalitingizga eng kam kerakli huquqni bering va taxmin qilish o'rniga javobni tekshiring.
Bu yakuniy nuqta hech qanday tashkilot identifikatorini qabul qilmaydi. Sizning kalitingiz unga tegishli tashkilotni allaqachon aniqlaydi va javob shunga qarab cheklanadi.
Sinab ko'rish
Qavslardagi har qanday narsani o'z qiymatlaringiz bilan, kalit pleysxolderini эsa boshqaruv panelingizdagi kalit bilan almashtiring.
curl -X POST https://api.zinndigital.com/v1/syndication/posts/{postId}/{action} \
-H "Authorization: Bearer zdk_live_…"Tizimga kirganmisiz? Boshqaruv panelingizdagi API konsoli haqiqiy tashkilot ID raqamingiz va shaxsiy kalitingizni avtomatik to'ldiradi hamda haqiqiy javobni ko'rishingiz uchun so'rovni jonli API orqali bajaradi. Ushbu yakuniy nuqtani API konsolida oching
Tafsilotlar
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`.
Parametrlar
| Nomi | Turi | Majburiy | Nima bu |
|---|---|---|---|
postId (path) | string | Ha | — |
action (path) | string<approve, reject, retry> | Ha | `approve` clears a held post for sending, `reject` marks it `skipped` (nothing went wrong — the customer said no), `retry` re-queues a failed one. |
Javob
| Nomi | Turi | Majburiy | Nima bu |
|---|---|---|---|
id | string | Ha | — |
channel | string | Ha | — |
connection_id | string | Ha | — |
connection_label | string | Ha | — |
status | string<drafting, awaiting_approval, queued, posted, failed, needs_reconnect, skipped> | Ha | ⛔⛔ `needs_reconnect` is NOT `failed`. `skipped` means the customer said no or the connection was removed — nothing went wrong. |
text | string | Ha | — |
remote_url | string | Ha | 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[][] | Ha | `[[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 | Ha | A machine code, never a sentence. |
cost_micros | integer | Ha | What this post cost us, in USD micros. One line per channel per post. |
character_limit | integer | Ha | — |
posted_at | string | Ha | — |
Ushbu yakuniy nuqta qaytarishi mumkin bo'lgan xatolar
401 · 403 · 404