syndication

POST `/v1/syndication/connections`

Connect a social account.

Autentificare

Trimiteți o cheie API ca token de tip bearer. Acest punct final nu specifică o permisiune anume în specificație, așa că acordați cheii cele mai puține drepturi necesare și verificați răspunsul în loc să faceți presupuneri.

Unde merge ID-ul organizației tale

Acest punct final acceptă org_id ca parametru de interogare. Omiteți-l și apelul va acoperi întregul subarbore al chiriașului dvs.; trimiteți-l pentru a restrânge apelul la o singură organizație.

ID-ul organizației tale se află pe ecranul cheilor API din panoul de control, lângă cheia însăși. Este același ID în fiecare apel pe care îl faci.

Încearcă

Înlocuiți tot ce se află între paranteze unghiulare cu propriile valori și substituentul cheie cu o cheie din tabloul de bord.

curl -X POST https://api.zinndigital.com/v1/syndication/connections \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "channel": <string>, "name": <string>, "credentials": <object> }'

Autentificat? Consola API din panoul de control îți completează ID-ul real al organizației și propria cheie și rulează cererea în API-ul live, astfel încât să poți vedea răspunsul efectiv. Deschideți acest punct final în consola API

Detalii

Stores the credential in Vault and the pointer on the row, then probes it immediately so the customer learns now whether it works rather than when their next article publishes. Gated on `syndication.manage`, which is a separate key from `links.edit` because this posts publicly on the customer's own brand accounts.

Parametri

Nume	Tip	Obligatoriu	Ce este
`org_id (query)`	`string`	Nu	Which organisation to connect it for, within the caller's subtree. ⛔ Scoped by `syndication.manage`, never by the reading key — a member holding only view on a client org must n…

Corp cerere

Nume	Tip	Obligatoriu	Ce este
`channel`	`string`	Da	—
`name`	`string`	Da	—
`credentials`	`object`	Da	Every value the channel's `fields` name. The secret half goes to Vault and is never returned.
`byo`	`boolean`	Nu	—

Răspuns

Nume	Tip	Obligatoriu	Ce este
`id`	`string`	Da	—
`channel`	`string`	Da	—
`name`	`string`	Da	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`	Da	The non-secret half — a handle, an instance, a board id.
`status`	`string<unverified, ready, needs_reconnect, error>`	Da	⛔⛔ `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`	Da	The account the VENDOR said this credential belongs to — discovered.
`verify_error`	`string`	Da	A machine code the dashboard turns into copy. Never a sentence.
`verified_at`	`string`	Da	—
`expires_at`	`string`	Da	⛔ `null` means no stated expiry, which is a different fact from "never expires" and must not render as an unqualified green.
`byo`	`boolean`	Da	Whether the customer supplied their own developer app.
`created_at`	`string`	Da	—

Erori pe care le poate returna acest punct final

401 · 403 · 422