links

GET `/v1/content/targets`

Which of your sites can receive a post, and why the rest cannot.

Uthibitishaji

Tuma ufunguo wa API kama tokeni ya kubeba. Sehemu hii ya mwisho haitaji ruhusa maalum katika maelezo, kwa hivyo ipe ufunguo wako kiwango cha chini kabisa kinachohitajika na uangalie jibu badala ya kukisia.

Mahali ambapo kitambulisho cha shirika lako huwekwa

Kigezo hiki kinachukua org_id kama kigezo cha utafutaji. Iache wazi na simu itashughulikia tawi lako lote la wapangaji; itume ili kupunguza simu iwe ya shirika moja tu.

Kitambulisho cha shirika lako kipo kwenye skrini ya funguo za API katika dashibodi yako, kando ya ufunguo wenyewe. Ni kitambulisho kile kile katika kila ombi unalofanya.

Jaribu

Badilisha chochote kilicho ndani ya mabano ya pembe na maadili yako mwenyewe, na kishikiliaji cha ufunguo na ufunguo kutoka kwa dashibodi yako.

curl -X GET https://api.zinndigital.com/v1/content/targets \
  -H "Authorization: Bearer zdk_live_…"

Umeingia kwenye akaunti? Dashibodi yako ya kiweko cha API inajaza kitambulisho chako halisi cha shirika na ufunguo wako mwenyewe, na kuendesha ombi dhidi ya API ya moja kwa moja ili uweze kuona jibu halisi. Fungua sehemu hii ya mwisho (endpoint) kwenye konsole ya API

Maelezo

Every live site in scope with its **suitability**: can it take an article, and — when it cannot — whose fact that is. Gated on `links.view`. ⛔⛔ `suitability` has five values and the difference between two of them is the whole point of this endpoint. `unsuitable` is **measured**: every adapter was asked which sites it claims and each one declined, so this kind of site genuinely has nowhere to put an article. `unknown` means **we could not determine it** — the box was unreachable, the credential has never been tested, or nothing has checked this site yet. A client MUST NOT render `unknown` as a refusal, MUST NOT silently exclude it from a selection, and SHOULD count it separately in any confirmation ("9 ready, 3 unchecked"). Treating "we could not look" as "no" is the defect this endpoint exists to prevent. ⛔ This endpoint makes **no outbound calls**. Suitability is served from the last stored probe with `checkedAt` beside it, because probing every row of a 500-site page would be an uncached external call in an interactive path. `checkedAt: null` means never checked and MUST be shown as such, not as a fresh result. Use `probeContentTargets` to refresh. ⭐ `requires` takes capability ids a recipe needs; each row then carries `missingCapabilities`, so an editor can grey a site out and say what it cannot do. A site whose capabilities are not established reports **nothing** missing rather than everything missing — for the same reason `unknown` is not `unsuitable`.

Vigezo

Jina	Aina	Inayohitajika	Kilicho hiki
`org_id (query)`	`string`	Hapana	Narrow to one organisation in a reseller subtree. Can never widen scope.
`q (query)`	`string`	Hapana	Match on domain or site name.
`suitability (query)`	`string<ready, needs_setup, unknown, unsuitable, blocked>`	Hapana	—
`product_line (query)`	`string`	Hapana	—
`stack_type (query)`	`string`	Hapana	—
`group_id (query)`	`string`	Hapana	Only sites in this site group.
`cms (query)`	`string<wordpress, headless_rest, git_static>`	Hapana	Only sites whose target is this kind.
`requires (query)`	`string`	Hapana	Comma-separated capability ids a recipe requires, e.g. `cms_target:featured_image,cms_target:category`.
`limit (query)`	`integer`	Hapana	—
`offset (query)`	`integer`	Hapana	—

Majibu

Jina	Aina	Inayohitajika	Kilicho hiki
`items`	`SiteTarget[]`	Ndiyo	—
`total`	`integer`	Ndiyo	Every site matching the filters, not the page. This is the number a select-all-matching control shows.
`offset`	`integer`	Ndiyo	—
`limit`	`integer`	Ndiyo	—
`has_more`	`boolean`	Ndiyo	—

Hitilafu ambazo mwisho huu unaweza kurudisha

401 · 403 · 422