syndication

PUT `/v1/syndication/connections/{connectionId}`

Rename a connection or replace its credential.

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 PUT https://api.zinndigital.com/v1/syndication/connections/{connectionId} \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{  }'

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

⛔ Omitting `credentials` KEEPS the stored credential rather than clearing it — a customer renaming a connection must not silently delete their token. Gated on `syndication.manage`.

Parametrlar

Nomi	Turi	Majburiy	Nima bu
`connectionId (path)`	`string`	Ha	—

Soʻrov tanasi

Nomi	Turi	Majburiy	Nima bu
`name`	`string`	Yo'q	—
`credentials`	`object`	Yo'q	⛔ Omit to KEEP the stored credential. Sending it replaces the secret half.

Javob

Nomi	Turi	Majburiy	Nima bu
`id`	`string`	Ha	—
`channel`	`string`	Ha	—
`name`	`string`	Ha	The customer's own name for it. ⛔ `name` on the wire, `label` on the model: `Field.label` is DRF's own attribute and shadowing it is silent at runtime.
`target`	`string`	Ha	The non-secret half — a handle, an instance, a board id.
`status`	`string<unverified, ready, needs_reconnect, error>`	Ha	⛔⛔ `needs_reconnect` is NOT a failure — the credential lapsed and only the customer can fix it. `unverified` means we have not looked, which is a third fact and not a quiet green.
`account_ref`	`string`	Ha	The account the VENDOR said this credential belongs to — discovered.
`verify_error`	`string`	Ha	A machine code the dashboard turns into copy. Never a sentence.
`verified_at`	`string`	Ha	—
`expires_at`	`string`	Ha	⛔ `null` means no stated expiry, which is a different fact from "never expires" and must not render as an unqualified green.
`byo`	`boolean`	Ha	Whether the customer supplied their own developer app.
`created_at`	`string`	Ha	—

Ushbu yakuniy nuqta qaytarishi mumkin bo'lgan xatolar

401 · 403 · 404

PUT /v1/syndication/connections/{connectionId}