links

PATCH `/v1/content/link-sets/{linkSetId}`

Rename a link set, archive it, or replace its links.

Pagpapatotoo

Magpadala ng API key bilang bearer token. Ang endpoint na ito ay hindi naglatag ng tiyak na pahintulot sa pagtutukoy, kaya ibigay sa iyong key ang pinakamababang kailangan nito at suriin ang tugon sa halip na umasa.

Ang endpoint na ito ay hindi nangangailangan ng id ng organisasyon. Natutukoy na ng iyong key ang organisasyong kinabibilangan nito, at nakatuon ang tugon dito.

Subukan ito

Palitan ang anuman sa loob ng mga panaklong na may anggulo ng iyong sariling mga halaga, at ang placeholder ng key na may key mula sa iyong dashboard.

curl -X PATCH https://api.zinndigital.com/v1/content/link-sets/{linkSetId} \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{  }'

Nakalagda? Ang API console sa iyong dashboard ay awtomatikong naglalagay ng iyong tunay na ID ng organisasyon at sariling susi, at pinapatakbo ang kahilingan laban sa live na API upang makita mo ang aktwal na tugon. Buksan ang endpoint na ito sa console ng API

Mga Detalye

Gated on `links.edit`. Sending `entries` replaces the whole list. That is safe for a link's placement history because the history is keyed on the URL and wording, not on a row id — so editing the list does not reset how often a link has been used.

Mga Parameter

Pangalan	Uri	Kailangan	Ano ito
`linkSetId (path)`	`string`	Oo	—

Katawan ng kahilingan

Pangalan	Uri	Kailangan	Ano ito
`name`	`string`	Hindi	—
`notes`	`string`	Hindi	—
`is_archived`	`boolean`	Hindi	—
`entries`	`LinkSetEntry[]`	Hindi	—

Tugon

Pangalan	Uri	Kailangan	Ano ito
`id`	`string`	Oo	—
`name`	`string`	Oo	—
`notes`	`string`	Oo	—
`is_archived`	`boolean`	Oo	An archived set is hidden from the picker and takes no new recipes; the recipes already using it keep working. Archiving is offered where deleting is refused.
`entries`	`LinkSetEntry[]`	Oo	—
`created_at`	`string`	Oo	—
`updated_at`	`string`	Oo	—
`recipe_count`	`integer`	Oo	How many recipes point at this set — so a delete button can say so first.
`distribution`	`object[]`	Oo	The resolved share of every (URL, wording) pair, summing to 100 — what will actually happen. Computed by the same function a run uses.
`distribution_error`	`string`	Oo	Why there is no distribution, or empty. Separate from `distribution` because an empty list also means "this set has no links", and one value for two facts is not an answer.

Mga error na maibabalik ng endpoint na ito

401 · 403 · 404 · 422

PATCH /v1/content/link-sets/{linkSetId}