hosting

POST `/v1/sites/{siteId}/website-backups`

Take a standard backup of a site's files and databases.

تصدیق‌هویت

یو API کی د بیئرر ټوکن (bearer token) په توګه ولیکئ. کی باید د hosting.backup.manage اجازه ولري؛ له دې اجازې پرته کی د 404 پرځای د 403 په واسطه رد کیږي.

دا پای نقطه د سازمان هېڅ آی ډي نه اخلي. ستاسو کیلي مخکې تر مخکې هغه سازمان په ګوته کوي چې پورې اړه لري، او ځواب ورته محدود دی.

هڅه وکړئ

د انګلیسي په زاوي پنسونو کې هرڅه د خپلو ارزښتونو سره بدل کړئ، او د کلي ځای لرونکی ستاسو د ډشبورډ د کلي سره.

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

ننوتي یاست؟ ستاسو په ډشبورډ کې د API کنسول ستاسو د اصلي سازمان ID او ستاسو خپله کیلي ډکوي، او غوښتنه د ژوندی API په وړاندې پرمخ وړي ترڅو تاسو وکولی شئ اصلي ځواب وګورئ. دا پای ټکی (endpoint) د API په کنسول کې پرانیزئ

تفصیلات

Asks the hosting platform to build a fresh archive of this site's files and databases. 202, because the platform runs the job afterwards and a 200 would claim an instant we never observed. ⛔ The response is the new state of the surface, never a bare acknowledgement — the client writes it straight into its cache, so an empty body would leave the button un-flipped and the poll never started. There is deliberately no restore verb on this resource: the platform restores this product from an archive the customer uploads by hand, so a Restore control here could only ever fail. 404 for a site with no vendor hosting package, or one that is not the caller's. Requires hosting.backup.manage.

پارامترونه

نوم	ډول	اړین	دا څه شی دی
`siteId (path)`	`Uuid`	هو	Site ID (UUIDv7).

ځواب

نوم	ډول	اړین	دا څه شی دی
`available`	`boolean`	هو	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`	هو	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`	هو	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.

تېروتنې چې دا پای ټکی یې بیرته راګرځولی شي

401 · 403 · 404 · 422 · 429 · 503

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