hosting
GET /v1/sites/{siteId}/website-backups
The standard backup a site's hosting package currently holds.
Doğrulama
API açarını bearer token kimi göndərin. Açar sites.view icazəsinə malik olmalıdır; bu icazəsi olmayan açar 404 deyil, 403 xətası ilə rədd edilir.
Bu endpoint heç bir təşkilat ID-si tələb etmir. Sizin açarınız artıq aid olduğu təşkilatı müəyyən edir və cavab həmin təşkilat üçün məhdudlaşdırılır.
Sınaqdan keçir
Bucaqlı mötərizələrdə olan hór şeyi öz qiymətlərinizlə, açar yertutucusunu isə idarə panelinizdən bir açarla əvəz edin.
curl -X GET https://api.zinndigital.com/v1/sites/{siteId}/website-backups \
-H "Authorization: Bearer zdk_live_…"Sistemə daxil olmusunuz? İdarə panelinizdəki API konsolu real təşkilatınızın identifikatorunu və öz açarınızı avtomatik doldurur, sorğunu canlı API-yə qarşı icra edir ki, siz faktiki cavabı görə biləsiniz. Bu son nöqtəni API konsolunda açın
Təfərrüatlar
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`.
Parametrlər
| Ad | Tip | Tələb olunur | Nədir |
|---|---|---|---|
siteId (path) | Uuid | Bəli | Site ID (UUIDv7). |
Cavab
| Ad | Tip | Tələb olunur | Nədir |
|---|---|---|---|
available | boolean | Bəli | Whether this site runs on a hosting package with a standard-backup surface at all. `false` renders nothing rather than an empty list. |
retention_hours | integer | Bəli | How 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. |
backup | WebsiteBackup | Bəli | The 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. |
Bu son nöqtənin qaytara biləcəyi xətalar
401 · 403 · 404 · 422 · 429 · 503