links

POST `/v1/content/external-sites`

Connect a WordPress site we do not host, with an application password.

Xaqiijinta aqoonsiga

U dir fure API ahaan calaamad muujisa (bearer token). Barta dhammaadka ee kani ma caysino luqad ahaan oggolaansho gaar ah oo ku dhex jirta qeexidda, markaa sii furahaaga inta ugu yar ee uu u baahan yahay oo fiiri jawaabta halka aad wax ka qaadan lahayd.

Meesha aqoonsiga ururkaagu galayo

Endpoint-kani wuxතික org_id oo ah cabbir su'aal ah. Ka tag oo wicitaanku wuxuu daboolayaa dhammaan geedkaaga kiraynta; soo dir si aad wicitaanka ugu koobto hal urur.

Aqoonsiga ururkaagu wuxuu ku yaallaa shaashada furayaasha API ee dashboard-kaaga, oo ku xiga furaha laftiisa. Waa isku aqoonsi wicitaan kasta oo aad sameyso.

Isku day

Ku beddel wax kasta oo ku dhex jira qeebaha xaglaha ah qiimayaashaada, sidoo kalena haystaaha furaha ku beddel fure ka dhex muuqda dashboordigaaga.

curl -X POST https://api.zinndigital.com/v1/content/external-sites \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "url": <string>, "username": <string>, "application_password": <string> }'

Ma sign-garaysay? Qalabka API ee ku jira dashboard-kaagu wuxuu buuxiyaa aqoonsigaaga ururka ee dhabta ah iyo furahaaga gaarka ah, wuxuuna ku shaqeysiiyaa codsiga API-ga nool si aad u aragto jawaabta dhabta ah. Kani ka fur barta kontoroolka ee API

Details

Gated on `links.edit`. The credential is **verified against the site before anything is stored**: if WordPress refuses it, nothing is created and the error says what to fix. The password goes to Vault; no secret is stored on the row. Generate the application password in that site's WordPress admin under Users → your user → Application Passwords. The user needs to be able to publish posts.

Cabiraha

Magaca	Nooc	Loo baahan yahay	Maxay tahay
`org_id (query)`	`string`	Maya	—

Codsiga jidhkiisa

Magaca	Nooc	Loo baahan yahay	Maxay tahay
`url`	`string`	Haa	The site's address, e.g. `https://example.com` or `https://example.com/blog`.
`username`	`string`	Haa	—
`application_password`	`string`	Haa	The application password WordPress generated. Spaces are ignored, so it may be pasted exactly as displayed.
`name`	`string`	Maya	—

Jawaab

Magaca	Nooc	Loo baahan yahay	Maxay tahay
`site_id`	`string`	Haa	—
`primary_domain`	`string`	Haa	—
`name`	`string`	Haa	—
`is_external`	`boolean`	Haa	Always true here. The same site appears in `/v1/sites` badged External.
`base_url`	`string`	Haa	The address we publish to, including any path (e.g. `https://example.com/blog`).
`reachable`	`boolean`	Maya	What the last check found. `null` means we have not checked, which is not the same as "it does not work" — an unchecked site is never rendered as broken.
`checked_at`	`string`	Maya	—
`detail`	`string`	Maya	What the site said last time, verbatim. Shown on the site's own screen.
`detected_identity`	`string`	Maya	—

Cilladaha ay bartaani soo celin karto

401 · 403 · 422