links

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

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

Doğrulama

API açarını bearer token kimi göndərin. Bu səhifə spresifikasiyada xüsusi icazə tələb etmir, buna görə də açarınıza ehtiyac duyduğu minimum səviyyədə icazə verin və güman etmək əvəzinə cavabı yoxlayın.

Bu endpoint heç bir təşkilat ID-si tələb etmir. Sizin açarınız artıq aid olduğu təşkilatı müəyyən edir və cavab həmin təşkilat üçün məhdudlaşdırılır.

Sınaqdan keçir

Bucaqlı mötərizələrdə olan hór şeyi öz qiymətlərinizlə, açar yertutucusunu isə idarə panelinizdən bir açarla əvəz edin.

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

Sistemə daxil olmusunuz? İdarə panelinizdəki API konsolu real təşkilatınızın identifikatorunu və öz açarınızı avtomatik doldurur, sorğunu canlı API-yə qarşı icra edir ki, siz faktiki cavabı görə biləsiniz. Bu son nöqtəni API konsolunda açın

Təfərrüatlar

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.

Parametrlər

Ad	Tip	Tələb olunur	Nədir
`linkSetId (path)`	`string`	Bəli	—

Sorğu gövdəsi

Ad	Tip	Tələb olunur	Nədir
`name`	`string`	Xeyr	—
`notes`	`string`	Xeyr	—
`is_archived`	`boolean`	Xeyr	—
`entries`	`LinkSetEntry[]`	Xeyr	—

Cavab

Ad	Tip	Tələb olunur	Nədir
`id`	`string`	Bəli	—
`name`	`string`	Bəli	—
`notes`	`string`	Bəli	—
`is_archived`	`boolean`	Bəli	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[]`	Bəli	—
`created_at`	`string`	Bəli	—
`updated_at`	`string`	Bəli	—
`recipe_count`	`integer`	Bəli	How many recipes point at this set — so a delete button can say so first.
`distribution`	`object[]`	Bəli	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`	Bəli	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.

Bu son nöqtənin qaytara biləcəyi xətalar

401 · 403 · 404 · 422

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