links

POST `/v1/content/external-sites`

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

Аутентификация

API кілтін bearer токені ретінде жіберіңіз. Бұл соңғы нүкте сипаттамада арнайы рұқсатты көрсетпейді, сондықтан болжағаннан гөрі кілтіңізге қажетті ең аз рұқсатты беріп, жауапты тексеріңіз.

Ұйымыңыздың идентификаторы орналасатын жер

Бұл соңғы нүкте сұрау параметрі ретінде org_id мәнін қабылдайды. Оны бос қалдырсаңыз, шақыру бүкіл жалға алушы тармағын қамтиды; шақыруды бір ұйымға шектеу үшін оны жіберіңіз.

Сіздің ұйым идентификаторыңыз басқару панеліндегі API кілттері экранында, кілттің өзінің жанында орналасқан. Бұл сіз жасайтын әрбір шақырудағы бірдей идентификатор.

Әрекет етіп көру

Бұрыштық жақшалардағы кез келген нәрсені өз мәндеріңізбен, ал кілт орналастырушысын басқару тақтасынан алынған кілтпен алмастырыңыз.

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> }'

Жүйеге кіргенсіз бе? Бақылау тақтасындағы API консолі ұйымыңыздың нақты идентификаторы мен жеке кілтіңізді автоматты түрде толтырады да, нақты жауапты көре алуыңыз үшін сұрауды тікелей жұмыс істеп тұрған API арқылы орындайды. Бұл соңғы нүктені API консолінде ашыңыз

Мәліметтер

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.

Параметрлер

Аты	Tүрі	Міндетті	Мазмұны
`org_id (query)`	`string`	Жоқ	—

Сұрау денесі

Аты	Tүрі	Міндетті	Мазмұны
`url`	`string`	Иә	The site's address, e.g. `https://example.com` or `https://example.com/blog`.
`username`	`string`	Иә	—
`application_password`	`string`	Иә	The application password WordPress generated. Spaces are ignored, so it may be pasted exactly as displayed.
`name`	`string`	Жоқ	—

Жауап

Аты	Tүрі	Міндетті	Мазмұны
`site_id`	`string`	Иә	—
`primary_domain`	`string`	Иә	—
`name`	`string`	Иә	—
`is_external`	`boolean`	Иә	Always true here. The same site appears in `/v1/sites` badged External.
`base_url`	`string`	Иә	The address we publish to, including any path (e.g. `https://example.com/blog`).
`reachable`	`boolean`	Жоқ	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`	Жоқ	—
`detail`	`string`	Жоқ	What the site said last time, verbatim. Shown on the site's own screen.
`detected_identity`	`string`	Жоқ	—

Бұл соңғы нүкте қайтара алатын қателер

401 · 403 · 422

POST /v1/content/external-sites