GET /v1/sites/deleted

المصادقة

أرسل مفتاح واجهة برمجة التطبيقات (API key) كرمز حامل (bearer token). يجب أن يحمل المفتاح إذن sites.view؛ والمفتاح الذي لا يملكه يُرفض بالرمز 403 وليس 404.

لا يقبل هذا الطرف أي معرف للمؤسسة. يحدد مفتاحك بالفعل المؤسسة التي ينتمي إليها، وتكون الاستجابة محصورة في نطاقها.

جربه الآن

استبدل أي شيء بين أقواس زاوية بقيمك الخاصة، والعنصر النائب للمفتاح بمفتاح من لوحة تحكمك.

curl -X GET https://api.zinndigital.com/v1/sites/deleted \
  -H "Authorization: Bearer zdk_live_…"

هل سجلت الدخول؟ تقوم وحدة تحكم واجهة برمجة التطبيقات في لوحة التحكم الخاصة بك بربط معرف مؤسستك الحقيقي ومفتاحك الخاص، وتنفذ الطلب مقابل واجهة برمجة التطبيقات المباشرة لتتمكن من رؤية الاستجابة الفعلية. افتح هذه النهاية الطرفية في وحدة تحكم API

التفاصيل

Every site deleted from the principal's orgs, newest first, with **an unambiguous date for when its backup is purged and the site becomes permanently unrecoverable** (`purge_due_at`). ⛔ **`purge_due_at` is computed by the engine from the live retention policy and must never be recomputed by a client.** It comes from the same function the purge sweep selects on, so the date shown and the date acted on cannot drift. A client adding `deleted_at + 30` would be a second hardcoded number, and it would be wrong the moment an operator edits the policy (D-W15-10b). ⛔ **`restorable` is a measurement, not a status.** It reflects a real check that the backup object exists in storage, so it is `false` — with `reason_code: no_backup` — for a site whose backup row claims success over bytes that were never written. A restore button over a backup that does not exist is worse than no button. Requires `sites.view` only: knowing which of your own sites were deleted, and by when they become unrecoverable, is not a privileged fact.

المعلمات

الاستجابة

الأخطاء التي يمكن أن تُرجعها نقطة النهاية هذه

401 · 403 · 429