links

GET /v1/link-edits/{editId}

One bulk edit, and what happened on every site.

Όλα τα τελικά σημεία links

Πισtoποίηση

Στείλτε ένα κλειδί API ως διακριτικό φορέα (bearer token). Αυτό το τελικό σημείο δεν ορίζει μια συγκεκριμένη άδεια στην προδιαγραφή, οπότε δώστε στο κλειδί σας τα ελάχιστα δυνατά δικαιώματα και ελέγξτε την απόκριση αντί να κάνετε υποθέσεις.

Αυτό το τελικό σημείο δεν δέχεται αναγνωριστικό οργανισμού. Το κλειδί σας προσδιορίζει ήδη τον οργανισμό στον οποίο ανήκει, και η απάντηση περιορίζεται σε αυτόν.

Δοκιμάστε το

Ατικatastήstε ό,τι βρίskεtai μέσα σe γώniaδeς μe τis δikές sas timές, kai to placeholder klεidioύ μe éna klεidi apó ton pinaka ελέgchou sas.

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

Συνδεθήκατε; Η κονσόλα API στον πίνακα ελέγχου σας συμπληρώνει το πραγματικό αναγνωριστικό του οργανισμού σας και το δικό σας κλειδί, και εκτελεί το αίτημα στο ζωντανό 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.

Παράμετροι

ΌνομαΤύpοςΥποχρεωτικόΤι είναι
editId (path)stringΝαιThe bulk edit's id.

Απάντηση

ΌνομαΤύpοςΥποχρεωτικόΤι είναι
idstringΝαι
target_idstringΌχι
target_hoststringΝαι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…
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_linksintegerΝαι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_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