links

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

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

Svi links krajnji točke

Sva developerska dokumentacija

Autentifikacija

Pošaljite API ključ kao bearer token. Ova krajnja točka ne navodi određenu dozvolu u specifikaciji, stoga dajte svom ključu najmanje što mu je potrebno i provjerite odgovor umjesto da pretpostavljate.

Ova krajnja točka ne prihvaća ID organizacije. Vaš ključ već identificira organizaciju kojoj pripada, a odgovor je ograničen na nju.

Isprobajte

Zamijenite sve unutar šiljastih zagrada svojim vlastitim vrijednostima, a rezervirano mjesto za ključ s ključem iz vaše nadzorne ploče.

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

Prijavljeni ste? API konzola na vašoj nadzornoj ploči automatski unosi stvarni ID vaše organizacije i vaš vlastiti ključ te šalje zahtjev prema aktivnom API-ju kako biste mogli vidjeti stvarni odgovor. Otvori ovu krajnju točku u API konzoli

Pojedinosti

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.

Parametri

NazivVrstaObaveznoŠto je to
linkSetId (path)stringDa

Tijelo zahtjeva

NazivVrstaObaveznoŠto je to
namestringNe
notesstringNe
is_archivedbooleanNe
entriesLinkSetEntry[]Ne

Odgovor

NazivVrstaObaveznoŠto je to
idstringDa
namestringDa
notesstringDa
is_archivedbooleanDaAn 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.
entriesLinkSetEntry[]Da
created_atstringDa
updated_atstringDa
recipe_countintegerDaHow many recipes point at this set — so a delete button can say so first.
distributionobject[]DaThe resolved share of every (URL, wording) pair, summing to 100 — what will actually happen. Computed by the same function a run uses.
distribution_errorstringDaWhy 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.

Pogreške koje ova krajnja točka može vratiti

401 · 403 · 404 · 422