hosting
GET /v1/sites/{siteId}/migrations/discoveries/{discoveryId}
Poll a discovery until it has an answer.
Πισtoποίηση
Στείλτε ένα κλειδί API ως διακριτικό φορέα (bearer token). Το κλειδί πρέπει να διαθέτει το δικαίωμα hosting.import.manage· ένα κλειδί που δεν το διαθέτει απορρίπτεται με 403, όχι 404.
Αυτό το τελικό σημείο δεν δέχεται αναγνωριστικό οργανισμού. Το κλειδί σας προσδιορίζει ήδη τον οργανισμό στον οποίο ανήκει, και η απάντηση περιορίζεται σε αυτόν.
Δοκιμάστε το
Ατικ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/sites/{siteId}/migrations/discoveries/{discoveryId} \
-H "Authorization: Bearer zdk_live_…"Συνδεθήκατε; Η κονσόλα API στον πίνακα ελέγχου σας συμπληρώνει το πραγματικό αναγνωριστικό του οργανισμού σας και το δικό σας κλειδί, και εκτελεί το αίτημα στο ζωντανό API, ώστε να μπορείτε να δείτε την πραγματική απόκριση. Ανοίξτε αυτό το τελικό σημείο στην κονσόλα API
Λεπτομέρειες
The row `discoverMigrationSource` created, as the workflow completes it. `outcome` is `pending` until the probe has run — a few seconds, up to about two minutes when the fingerprint table is not confident and a model is asked to read the sign-in page — and then `identified`, `unidentified` or `unreachable`. A workflow that could not finish leaves `unreachable` with the reason recorded; a row never stays `pending` for ever. Reads the row, never Temporal, so polling is cheap. Scoped to the site: another tenant's discovery id is a 404. Requires `hosting.import.manage`.
Παράμετροι
| Όνομα | Τύpος | Υποχρεωτικό | Τι είναι |
|---|---|---|---|
siteId (path) | Uuid | Ναι | Site ID (UUIDv7). |
discoveryId (path) | string | Ναι | The `discovery_id` a `discoverMigrationSource` call answered with. |
Απάντηση
| Όνομα | Τύpος | Υποχρεωτικό | Τι είναι |
|---|---|---|---|
outcome | string<pending, identified, unidentified, unreachable> | Ναι | `pending` while the discovery workflow is still probing — poll `getMigrationDiscovery` until it is one of the other three (D19865). ⛔ Three answers and never a boolean. `unident… |
host | string | Ναι | The hostname as it was normalised, which may differ from what was typed. |
source | string | Ναι | The best candidate's `MigrationSource`, or `""` when there is none. |
port | integer | Ναι | The **login** port for that source, which is not necessarily the port the evidence came from: a banner read from cPanel's plaintext 2082 reports 2083, because that is where the… |
confidence | integer | Ναι | — |
confident | boolean | Ναι | May the credential form be pre-filled from this? |
candidates | MigrationDiscoveryCandidate[] | Ναι | — |
expectations | string[] | Ναι | Machine codes for what to expect from the winning source — e.g. `ftp_files_only`. ⛔ Expectations, not a capability claim: the authoritative answer comes from the credentialed pr… |
routes | MigrationDiscoveryRoute[] | Ναι | Every way in that was tried. Read it when a panel is firewalled — a host with 2083 closed and 22 open can still have everything moved. |
proxy_fronted | boolean | Ναι | This address is a CDN in front of a website, not a hosting account — several different panels' login ports accepted a connection at once and none of them answered with its own n… |
refused | string | Ναι | A customer-readable reason the hostname was rejected before any packet went out — a private address, an unresolvable name. `""` otherwise. |
agent_used | boolean | Ναι | Whether a language model was asked to read the sign-in page. It is asked only when the deterministic table produced no confident panel. |
agent_unavailable | string | Ναι | Machine code when the model was asked and could not answer (`ai_unavailable`, `ai_timeout`, …). `""` when it was not asked or it answered. ⛔ The deterministic answer stands eith… |
discovery_id | string | Ναι | The recorded run, for support. `""` when the row could not be written — which never costs the customer their answer. |
Σφάλματα που μπορεί να επιστρέψει αυτό το τελικό σημείο
401 · 403 · 404 · 429