hosting

PUT /v1/sites/{siteId}/cms-target

Tell us where this site's posts should go.

Të gjitha pikat e skajshme hosting

Autentifikimi

Drgoni një çelës API si një token mbajtës. Ky pikëndalim nuk specifikon një leje specifike në specifikim, prandaj jepini çelësit tuaj minimumin e nevojshëm dhe kontrolloni përgjigjen në vend që të supozoni.

Ky pikëndalim nuk pranon id të organizatës. Çelësi juaj tashmë identifikon organizatën së cilës i përket dhe përgjigjja kufizohet vetëm për atë.

Provoje

Zëvendësoni çdo gjë brenda kllapave këndore me vlerat tuaja dhe vendbanuesin e çelësit me një çelës nga paneli juaj.

curl -X PUT https://api.zinndigital.com/v1/sites/{siteId}/cms-target \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "kind": <string<wordpress, headless_rest, git_static>> }'

Jeni kyçur? Konsola e API-së në panelin tuaj plotëson ID-në tuaj reale të organizatës dhe çelësin tuaj, dhe ekzekuton kërkesën kundrejt API-së live, kështu që ju mund të shihni përgjigjen aktuale. Hapni këtë pikë fundore në konsolën e API-së

Detajet

Creates or replaces the site's content target. Gated on `links.edit`. ⛔ `secret` is write-only, and **omitting it keeps the credential you already have** rather than clearing it — a customer editing a collection name must not silently delete their key. The secret is written to Vault **before** the row is saved, and the row is only written if that succeeded: the other order leaves a row that reads as configured on every screen and fails at the first publish.

Parametrat

EmriLlojiKërkohetÇfarë është kjo
siteId (path)stringPo

Trupi i kërkesës

EmriLlojiKërkohetÇfarë është kjo
kindstring<wordpress, headless_rest, git_static>Po
presetstring<, payload, strapi, directus, ghost, shopify, webflow, custom>Jo
base_urlstringJo
collectionstringJo
auth_schemestring<, bearer, payload_api_key, ghost_admin_jwt, shopify_token, header>Jo
auth_headerstringJo
field_mapobjectJo
enabledbooleanJo
secretstringJoThe API key. ⛔ Write-only, and **omitting it keeps the credential you already have** rather than clearing it. It is written to Vault before the row is saved, and the row is only…

Përgjigja

EmriLlojiKërkohetÇfarë është kjo
site_idstringPo
kindstring<, wordpress, headless_rest, git_static>PoEmpty when nothing claims this site. For a site with no configured row this is the **derived** target — most WordPress sites on our own fleet need no configuration at all, becau…
presetstring<, payload, strapi, directus, ghost, shopify, webflow, custom>Po
base_urlstringPoThe CMS's API root. Empty for a target whose address is derived from the site (fleet WordPress, a connected Git repository).
collectionstringPoThe collection posts are created in — `posts` on Payload, a blog id on Shopify, a collection id on Webflow, the content directory on a Git target.
auth_schemestring<, bearer, payload_api_key, ghost_admin_jwt, shopify_token, header>Po
auth_headerstringPoFor the `header` auth scheme — which header the key is sent in.
field_mapobjectPoRenames, for a destination that spells our fields differently. ⛔ It **renames**; it never adds a capability. A field map cannot make a target able to carry a tag it has no field…
enabledbooleanPoA disabled target is skipped and reads as `needs_setup` — kept rather than deleted so pausing publishing to a site does not lose its set-up.
has_credentialbooleanPo
capabilitiesstring[]Po
detected_identitystringPoWhat the destination said it was, last time it answered.
last_probe_atstringPo
last_probe_reachablebooleanPo⛔ `null` means **never probed**; `false` means probed and could not be reached. Those are different facts and a client must not render them the same.
last_probe_codestringPo
last_probe_detailstringPo

Gabimet që ky pikëndalim mund të kthejë

401 · 403 · 404 · 422