hosting
DELETE /v1/sites/{siteId}/external-backup
Remove our access to an externally hosted site.
การยืนยันตัวตน
ส่ง API key ในรูปแบบ bearer token คีย์ดังกล่าวต้องมีสิทธิ์ hosting.backup.manage หากไม่มีสิทธิ์ ระบบจะปฏิเสธด้วยรหัส 403 แทนที่จะเป็น 404
ปลายทางนี้ไม่ต้องใช้รหัสองค์กร คีย์ของคุณระบุองค์กรที่เป็นเจ้าของอยู่แล้ว และการตอบกลับจะถูกจำกัดขอบเขตไว้เฉพาะองค์กรนั้น
ทดลองใช้เลย
แทนที่สิ่งใดๆ ที่อยู่ภายในวงเล็บแหลมด้วยค่าของคุณเอง และตัวยึดตำแหน่งคีย์ด้วยคีย์จากแดชบอร์ดของคุณ
curl -X DELETE https://api.zinndigital.com/v1/sites/{siteId}/external-backup \
-H "Authorization: Bearer zdk_live_…"เข้าสู่ระบบแล้วใช่ไหม คอนโซล API ในแดชบอร์ดของคุณจะเติมรหัสองค์กรจริงและคีย์ของคุณเองโดยอัตโนมัติ และทำการส่งคำขอไปยัง API จริง เพื่อให้คุณเห็นผลลัพธ์ที่เป็นข้อมูลจริง เปิดจุดสิ้นสุดนี้ในคอนโซล API
รายละเอียด
Deletes the connection and forgets the stored credential. The backups themselves are **not** deleted. A customer disconnecting us may be doing it precisely so they can restore elsewhere, and their existing restore points are theirs — they expire on the normal retention schedule and are all still downloadable. Requires `hosting.backup.manage`.
พารามิเตอร์
| ชื่อ | ประเภท | จำเป็นต้องมี | ลักษณะของสิ่งนี้ |
|---|---|---|---|
siteId (path) | Uuid | ใช่ | Site ID (UUIDv7). |
การตอบกลับ
| ชื่อ | ประเภท | จำเป็นต้องมี | ลักษณะของสิ่งนี้ |
|---|---|---|---|
configured | boolean | ใช่ | False when nobody has connected this site yet. The rest of the object is still present and empty — a screen must not have to tell "not set up" from "failed to load" by the absen… |
channel | ExternalBackupChannel | string<> | ใช่ | Empty string when `configured` is false. |
enabled | boolean | ใช่ | A disabled connection is paused, not deleted — the set-up survives. |
can_restore | boolean | ใช่ | Whether we can push a backup back down this channel. **False for `connector`**, and that is not a limitation to route around: a WordPress plugin cannot run inside a WordPress to… |
summary | string | ใช่ | One sentence stating what this connection can and cannot do, composed server-side so every surface says the same thing about the backup/restore asymmetry. |
ssh_host | string | ใช่ | Empty on a `connector` connection. |
ssh_port | integer | ใช่ | — |
ssh_username | string | ใช่ | — |
remote_path | string | ใช่ | The site's document root — what we archive, and what we restore into. |
credential_present | boolean | ใช่ | Whether a credential is stored in our secret store. The credential itself is never returned by any endpoint. |
last_verified_at | string | ใช่ | Null when the connection has never been checked. |
last_verified_ok | boolean | ใช่ | Null means never checked, which is not the same as failing — the absence of a measurement is not a measurement. |
last_verify_detail | string | ใช่ | — |
ข้อผิดพลาดที่เอนด์พอยต์นี้สามารถส่งกลับได้
401 · 403 · 404 · 422