hosting
GET /v1/sites/deleted
List my deleted sites, and when each stops being recoverable.
Autenticación
Envía una clave de API como token de portador. La clave debe tener el permiso sites.view; una clave que no lo tenga se rechazará con un código 403, no 404.
Este endpoint no requiere ningún id de organización. Su clave ya identifica la organización a la que pertenece, y la respuesta está delimitada a ella.
Pruébalo
Reemplaza cualquier elemento entre corchetes angulares por tus propios valores, y el marcador de posición key con una clave de tu panel de control.
curl -X GET https://api.zinndigital.com/v1/sites/deleted \
-H "Authorization: Bearer zdk_live_…"¿Has iniciado sesión? La consola de la API en tu panel de control rellena el ID de tu organización real y tu propia clave, y ejecuta la solicitud contra la API en vivo para que puedas ver la respuesta real. Abre este endpoint en la consola de la API
Detalles
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.
Parámetros
| Nombre | Tipo | Obligatorio | ¿Qué es esto? |
|---|---|---|---|
cursor (query) | string | No | Opaque cursor from a previous page's `page.next_cursor`. |
limit (query) | integer | No | Maximum items to return (page size). |
Respuesta
| Nombre | Tipo | Obligatorio | ¿Qué es esto? |
|---|---|---|---|
data | DeletedSite[] | Sí | — |
page | PageMeta | Sí | — |
Errores que este endpoint puede devolver
401 · 403 · 429