hosting

POST /v1/sites/{siteId}/site-blueprint-deploy

Replace a site's content with a blueprint's.

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

Όλα τα έγγραφα προγραμματιστών

Πισ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 POST https://api.zinndigital.com/v1/sites/{siteId}/site-blueprint-deploy \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "blueprint_id": <Uuid> }'

Συνδεθήκατε; Η κονσόλα API στον πίνακα ελέγχου σας συμπληρώνει το πραγματικό αναγνωριστικό του οργανισμού σας και το δικό σας κλειδί, και εκτελεί το αίτημα στο ζωντανό API, ώστε να μπορείτε να δείτε την πραγματική απόκριση. Ανοίξτε αυτό το τελικό σημείο στην κονσόλα API

Λεπτομέρειες

Destructive. This overwrites the site's live database and files with the contents of the named blueprint, then rewrites the restored content's stored web addresses to this site's domain (a WordPress database names its own URLs, so without that step the new site would redirect its visitors to the old one). Its own path on the site, beside backups/restore, rather than a verb on the blueprint — the destruction happens here, so it is gated on hosting.backup.manage and cannot be reached by varying the body of anything gentler. ⛔ A blueprint captured from a different stack is refused with a 422 (stack_mismatch) — WordPress can only be deployed onto WordPress. So is one from a different hosting platform (platform_mismatch), whose archive our adapter cannot restore here. A blueprint belonging to a different account is refused with org_mismatch, even when your token can reach both: hierarchical tenancy means a reseller's key spans every client organisation, and a blueprint is that site's whole database — it never crosses between accounts. A blueprint that is still being captured is blueprint_not_ready. A deploy already in flight on this site is a 409. The refusal is a machine code, carried in error.details[0].code, so a client can render it in the customer's own language; error.message is the English equivalent for a caller with no catalogue. ⛔ Read the code from details, not from error.code — that is the generic UNPROCESSABLE_ENTITY for every 422 this API produces.

Παράμετροι

ΌνομαΤύpοςΥποχρεωτικόΤι είναι
siteId (path)UuidΝαιSite ID (UUIDv7).
Idempotency-Key (header)stringΌχιClient-generated key that makes an unsafe request replay-safe: the server stores the first response and returns it verbatim for repeats.

Σώμα αίτησης

ΌνομαΤύpοςΥποχρεωτικόΤι είναι
blueprint_idUuidΝαιThe SITE blueprint to deploy. ⛔ Always named explicitly — never "the latest". This overwrites a live site.

Απάντηση

ΌνομαΤύpοςΥποχρεωτικόΤι είναι
idUuidΝαιUUIDv7 identifier — sortable by creation time (docs/02 §8).
blueprint_idUuidΝαιUUIDv7 identifier — sortable by creation time (docs/02 §8).
site_idUuidΝαιUUIDv7 identifier — sortable by creation time (docs/02 §8).
statusSiteBlueprintDeployStatusΝαιwaiting is a real state and not a synonym for pending. A deploy started from the create form cannot restore anything until the new site has finished provisioning, which…
messagestringΌχιWhy it failed, or — after a successful restore whose URL rewrite did not take — what still needs attention. Rendered to the customer verbatim.
started_atobjectΌχι
finished_atobjectΌχι
created_atstringΝαι

Σφάλματα που μπορεί να επιστρέψει αυτό το τελικό σημείο

401 · 403 · 404 · 409 · 422 · 429 · 503