hosting

GET /v1/sites/{siteId}/website-backups

The standard backup a site's hosting package currently holds.

Wszystkie punkty końcowe hosting

Wszystkie dokumentacje dla programistów

Uwierzytelnianie

Wyślij klucz API jako token bearer. Klucz musi posiadać uprawnienie sites.view; klucz bez niego jest odrzucany z kodem 403, a nie 404.

Ten punkt końcowy nie wymaga identyfikatora organizacji. Twój klucz już identyfikuje organizację, do której należy, a odpowiedź jest do niej ograniczona.

Wypróbuj

Zastąp wszystko w nawiasach ostrych własnymi wartościami, a zastępczy znacznik klucza kluczem ze swojego pulpitu nawigacyjnego.

curl -X GET https://api.zinndigital.com/v1/sites/{siteId}/website-backups \
  -H "Authorization: Bearer zdk_live_…"

Zalogowany? Konsola API w Twoim panelu uzupełnia rzeczywiste identyfikator organizacji oraz Twój własny klucz i wykonuje żądanie względem aktywnego API, dzięki czemu możesz zobaczyć rzeczywistą odpowiedź. Otwórz ten punkt końcowy w konsoli API

Szczegóły

The hosting platform's included on-demand backup for this site — a downloadable archive of files and databases. This is a different product from getSiteVendorSnapshots, which is the platform's paid point-in-time service, and from listSiteBackups, which is our own archive. ⛔ The platform deletes one of these after retention_hours (12 today). That is the character of the product: it is a button, not a history, and a client must render the real age rather than presenting it as durable protection. backup is null when the platform holds none — never when we failed to ask, which is an error status. ⭐ complete is not status restated: it also requires a download_url, because a job reporting completion with no archive is nothing the customer can act on. 404 for a site with no vendor hosting package, or one that is not the caller's. Requires sites.view.

Parametry

NazwaTypWymaganeCo to jest
siteId (path)UuidTakSite ID (UUIDv7).

Odpowiedź

NazwaTypWymaganeCo to jest
availablebooleanTakWhether this site runs on a hosting package with a standard-backup surface at all. false renders nothing rather than an empty list.
retention_hoursintegerTakHow long the platform keeps one. Sent rather than hardcoded in the client so the screen can show a real expiry, and so it cannot drift if the platform changes it.
backupWebsiteBackupTakThe current backup, or null when the platform holds none. ⛔ null never means we failed to ask — that is an error status, not an empty surface.

Błędy, które ten punkt końcowy może zwrócić

401 · 403 · 404 · 422 · 429 · 503