links
POST /v1/link-edits/{editId}/undo
Put back exactly what a bulk edit replaced.
المصادقة
أرسل مفتاح واجهة برمجة التطبيقات (API) كرمز حامل (bearer token). لا يحدد نقطة النهاية هذه إذنًا محددًا في المواصفات، لذا امنح مفتاحك الحد الأدنى الذي محتاجه وتحقق من الاستجابة بدلاً من الافتراض.
لا يقبل هذا الطرف أي معرف للمؤسسة. يحدد مفتاحك بالفعل المؤسسة التي ينتمي إليها، وتكون الاستجابة محصورة في نطاقها.
جربه الآن
استبدل أي شيء بين أقواس زاوية بقيمك الخاصة، والعنصر النائب للمفتاح بمفتاح من لوحة تحكمك.
curl -X POST https://api.zinndigital.com/v1/link-edits/{editId}/undo \
-H "Authorization: Bearer zdk_live_…"هل سجلت الدخول؟ تقوم وحدة تحكم واجهة برمجة التطبيقات في لوحة التحكم الخاصة بك بربط معرف مؤسستك الحقيقي ومفتاحك الخاص، وتنفذ الطلب مقابل واجهة برمجة التطبيقات المباشرة لتتمكن من رؤية الاستجابة الفعلية. افتح هذه النهاية الطرفية في وحدة تحكم API
التفاصيل
Reverses the items that actually **applied** — a `stale` item is not reversed, because re-inserting a link the customer had already removed themselves would be a change nobody asked for, and a failed item never wrote anything to put back. Once. A second undo would reverse the first and put the original change back, which is the opposite of what the button says, so it is a `409`.
المعلمات
| الاسم | النوع | مطلوب | ما هو هذا |
|---|---|---|---|
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 · 409 · 422 · 503