links

GET `/v1/link-edits/{editId}`

One bulk edit, and what happened on every site.

المصادقة

أرسل مفتاح واجهة برمجة التطبيقات (API) كرمز حامل (bearer token). لا يحدد نقطة النهاية هذه إذنًا محددًا في المواصفات، لذا امنح مفتاحك الحد الأدنى الذي محتاجه وتحقق من الاستجابة بدلاً من الافتراض.

لا يقبل هذا الطرف أي معرف للمؤسسة. يحدد مفتاحك بالفعل المؤسسة التي ينتمي إليها، وتكون الاستجابة محصورة في نطاقها.

جربه الآن

استبدل أي شيء بين أقواس زاوية بقيمك الخاصة، والعنصر النائب للمفتاح بمفتاح من لوحة تحكمك.

curl -X GET https://api.zinndigital.com/v1/link-edits/{editId} \
  -H "Authorization: Bearer zdk_live_…"

هل سجلت الدخول؟ تقوم وحدة تحكم واجهة برمجة التطبيقات في لوحة التحكم الخاصة بك بربط معرف مؤسستك الحقيقي ومفتاحك الخاص، وتنفذ الطلب مقابل واجهة برمجة التطبيقات المباشرة لتتمكن من رؤية الاستجابة الفعلية. افتح هذه النهاية الطرفية في وحدة تحكم API

التفاصيل

Poll this while `status` is `pending` or `running`. Each entry in `items` is one site, and it carries the exact strings that were replaced — an edit screen that reports "197 links changed" and cannot show you one of them is asking to be trusted rather than checked. Gated on `links.view`: reading what was done is reading.

المعلمات

الاسم	النوع	مطلوب	ما هو هذا
`editId (path)`	`string`	نعم	The bulk edit's id.

الاستجابة

الاسم	النوع	مطلوب	ما هو هذا
`id`	`string`	نعم	—
`target_id`	`string`	لا	—
`target_host`	`string`	نعم	The host as it read when the edit was made. Kept as a string as well as a key, because a rewrite can empty a target of its last link and an audit line reading "edited (deleted t…
`action`	`string<rewrite, unlink>`	نعم	—
`new_href`	`string`	لا	—
`new_text`	`string`	لا	New visible text. Empty means keep whatever each link already says — which is the common case, because one target's links carry many different anchors and flattening them all…
`status`	`string<pending, running, applied, partial, failed>`	نعم	`partial` is the honest answer when some sites succeeded and some did not, and it exists because the other two are lies in that case: an operator's next action depends entirely…
`expected_links`	`integer`	نعم	What the operator was told would change, recorded when they confirmed it rather than recomputed later. The whole value of a confirmation is that it can be held up against th…
`expected_posts`	`integer`	نعم	—
`expected_sites`	`integer`	نعم	—
`undo_of`	`string`	لا	The edit this one reverses, if any.
`undone_by`	`string`	لا	The edit that has already reversed this one. Present so the screen offers undo once — two undos of one edit put the original change back.
`created_at`	`string`	نعم	—
`finished_at`	`string`	لا	—
`items`	`LinkEditItem[]`	لا	—

الأخطاء التي يمكن أن تُرجعها نقطة النهاية هذه

401 · 403 · 404

GET /v1/link-edits/{editId}