links
GET /v1/link-edits/{editId}
One bulk edit, and what happened on every site.
Autentizace
Odešlete klíč API jako bearer token. Tento koncový bod ve specifikaci uvádí specifické oprávnění, takže svému klíči udělte to nejmenší možné a místo předpokladů zkontrolujte odpověď.
Tento koncový bod nevyžaduje žádné ID organizace. Váš klíč již identifikuje organizaci, ke které patří, a odpověď je na ni omezena.
Vyzvednout
Nahraďte cokoli v závorkách vlastními hodnotami a zástupný symbol klíče klíčem z vašeho řídicího panelu.
curl -X GET https://api.zinndigital.com/v1/link-edits/{editId} \
-H "Authorization: Bearer zdk_live_…"Přihlášeni? Konzole API ve vašem dashboardu automaticky doplní vaše skutečné ID organizace i váš vlastní klíč a odešle požadavek na živé API, abyste viděli reálnou odpověď. Otevřete tento koncový bod v konzoli API
Podrobnosti
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.
Parametry
| Název | Typ | Požadováno | Co to je |
|---|---|---|---|
editId (path) | string | Ano | The bulk edit's id. |
Odpověď
| Název | Typ | Požadováno | Co to je |
|---|---|---|---|
id | string | Ano | — |
target_id | string | Ne | — |
target_host | string | Ano | 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> | Ano | — |
new_href | string | Ne | — |
new_text | string | Ne | 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> | Ano | `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 | Ano | 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 | Ano | — |
expected_sites | integer | Ano | — |
undo_of | string | Ne | The edit this one reverses, if any. |
undone_by | string | Ne | 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 | Ano | — |
finished_at | string | Ne | — |
items | LinkEditItem[] | Ne | — |
Chyby, které může tento koncový bod vrátit
401 · 403 · 404