hosting
GET /v1/sites/{siteId}/protection/file-permissions
Run the vendor's file-permission check on a site.
Autentificare
Trimiteți o cheie API ca token de tip bearer. Cheia trebuie să aibă permisiunea sites.view; o cheie care nu o are va fi respinsă cu 403, nu 404.
Acest endpoint nu necesită un ID de organizație. Cheia ta identifică deja organizația căreia îi aparține, iar răspunsul este limitat la aceasta.
Încearcă
Înlocuiți tot ce se află între paranteze unghiulare cu propriile valori și substituentul cheie cu o cheie din tabloul de bord.
curl -X GET https://api.zinndigital.com/v1/sites/{siteId}/protection/file-permissions \
-H "Authorization: Bearer zdk_live_…"Autentificat? Consola API din panoul de control îți completează ID-ul real al organizației și propria cheie și rulează cererea în API-ul live, astfel încât să poți vedea răspunsul efectiv. Deschideți acest punct final în consola API
Detalii
⛔ **This `GET` RUNS the scan — it is not a cached read.** The vendor's read *is* the check, so it walks the site's filesystem. It is an explicit *"check my permissions"* action and must never fire on mount or on window focus. `check_id` is the handle the fix needs, and it is **nullable**: null means the vendor gave us no handle, so `actionable` is false and there is nothing to apply. `recommended` on each failure is nullable for the same reason — the platform sometimes names a file without naming a mode, and a guessed `644` would be applied to the customer's file. `404` for a site with no vendor hosting package. Requires `sites.view`.
Parametri
| Nume | Tip | Obligatoriu | Ce este |
|---|---|---|---|
siteId (path) | Uuid | Da | Site ID (UUIDv7). |
Răspuns
| Nume | Tip | Obligatoriu | Ce este |
|---|---|---|---|
check_id | integer | Da | The vendor's handle for this check. **Null** when the vendor gave us none, in which case there is nothing to apply and `actionable` is false. ⛔ A client never sends it back: `fi… |
public_html_wrong | boolean | Da | Whether the document root's own mode is wrong. |
root_wrong | boolean | Da | Whether the package root's own mode is wrong. |
failures | SitePermissionFailure[] | Da | The individual files the check flagged. |
actionable | boolean | Da | Whether *Fix these* can do anything: a live check handle **and** something to fix. Its own field so the button is not offered against a report that can only be refused. |
Erori pe care le poate returna acest punct final
401 · 403 · 404 · 429 · 503