links

GET /v1/link-edits/{editId}

One bulk edit, and what happened on every site.

모든 links 엔드포인트

인증

Bearer 토큰으로 API 키를 전송하세요. 이 엔드포인트는 명세에 특정 권한을 명시하지 않으므로, 가정하기보다는 키에 필요한 최소한의 권한을 부여하고 응답을 확인하세요.

이 엔드포인트는 조직 ID를 받지 않습니다. 사용자의 키가 이미 속한 조직을 식별하며, 응답은 해당 조직으로 한정됩니다.

무료 체험하기

대괄호 안에 있는 모든 내용을 사용자 지정 값으로 바꾸고, 키 플레이스홀더는 대시보드의 키로 바꾸세요.

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

로그인하셨나요? 대시보드의 API 콘솔이 실제 조직 ID와 본인의 키를 자동으로 채우고 라이브 API를 대상으로 요청을 실행하므로 실제 응답을 확인할 수 있습니다. 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)stringThe bulk edit's id.

응답

이름유형필수설명
idstring
target_idstring아니요
target_hoststringThe 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…
actionstring<rewrite, unlink>
new_hrefstring아니요
new_textstring아니요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…
statusstring<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_linksintegerWhat 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_postsinteger
expected_sitesinteger
undo_ofstring아니요The edit this one reverses, if any.
undone_bystring아니요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_atstring
finished_atstring아니요
itemsLinkEditItem[]아니요

이 엔드포인트가 반환할 수 있는 오류

401 · 403 · 404