links
GET /v1/link-edits/{editId}
One bulk edit, and what happened on every site.
Xaqiijinta aqoonsiga
U dir fure API ahaan calaamad muujisa (bearer token). Barta dhammaadka ee kani ma caysino luqad ahaan oggolaansho gaar ah oo ku dhex jirta qeexidda, markaa sii furahaaga inta ugu yar ee uu u baahan yahay oo fiiri jawaabta halka aad wax ka qaadan lahayd.
Boggan ma qaato aqoonsiga ururka. Furahaagu wuxuu horay u aqoonsanayaa ururka uu ka tirsan yahay, jawaabtuna waxay ku kooban tahay halkaas.
Isku day
Ku beddel wax kasta oo ku dhex jira qeebaha xaglaha ah qiimayaashaada, sidoo kalena haystaaha furaha ku beddel fure ka dhex muuqda dashboordigaaga.
curl -X GET https://api.zinndigital.com/v1/link-edits/{editId} \
-H "Authorization: Bearer zdk_live_…"Ma sign-garaysay? Qalabka API ee ku jira dashboard-kaagu wuxuu buuxiyaa aqoonsigaaga ururka ee dhabta ah iyo furahaaga gaarka ah, wuxuuna ku shaqeysiiyaa codsiga API-ga nool si aad u aragto jawaabta dhabta ah. Kani ka fur barta kontoroolka ee API
Faahfaahin
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.
Cabiraha
| Magaca | Nooc | Loo baahan yahay | Maxay tahay |
|---|---|---|---|
editId (path) | string | Haa | The bulk edit's id. |
Jawaab
| Magaca | Nooc | Loo baahan yahay | Maxay tahay |
|---|---|---|---|
id | string | Haa | — |
target_id | string | Maya | — |
target_host | string | Haa | 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> | Haa | — |
new_href | string | Maya | — |
new_text | string | Maya | 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> | Haa | `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 | Haa | 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 | Haa | — |
expected_sites | integer | Haa | — |
undo_of | string | Maya | The edit this one reverses, if any. |
undone_by | string | Maya | 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 | Haa | — |
finished_at | string | Maya | — |
items | LinkEditItem[] | Maya | — |
Cilladaha ay bartaani soo celin karto
401 · 403 · 404