Autenticazione
Invia una chiave API come token di tipo bearer. La chiave deve disporre dell'autorizzazione sites.view; una chiave sprovvista di tale autorizzazione viene rifiutata con 403 anziché 404.
Questo endpoint non richiede alcun ID organizzazione. La tua chiave identifica già l'organizzazione a cui appartiene e la risposta è limitata ad essa.
Provalo
Sostituisci qualsiasi elemento tra parentesi angolari con i tuoi valori e il segnaposto key con una chiave dalla tua dashboard.
curl -X GET https://api.zinndigital.com/v1/sites/{siteId}/databases \
-H "Authorization: Bearer zdk_live_…"Hai effettuato l'accesso? La console API nella tua dashboard inserisce il tuo ID organizzazione reale e la tua chiave personale, ed esegue la richiesta sull'API live in modo da poter vedere la risposta effettiva. Apri questo endpoint nella console API
Dettagli
The MySQL databases on the site's hosting package, with the user bound to each so a connection string can be assembled. **No password is returned**: a database password exists in exactly one response on this platform, the one that created it, and there is no endpoint that reads one back. `limit` is the effective ceiling — the lower of what the package permits and what the customer bought. `permitted` and `can_create` answer the two different questions a screen must distinguish before it offers an "add" button. This is the customer's own control surface. It is deliberately **not** a link to any vendor database tool: no customer is ever sent to a vendor control panel (docs/62 §3.7). `404` for a site with no vendor hosting package. Requires `sites.view`.
Parametri
| Nome | Tipo | Obbligatorio | Che cos'è |
|---|---|---|---|
siteId (path) | Uuid | Sì | Site ID (UUIDv7). |
Risposta
| Nome | Tipo | Obbligatorio | Che cos'è |
|---|---|---|---|
data | SiteHostingDatabase[] | Sì | The databases on the package. |
limit | VendorAllowance | Sì | The effective ceiling on databases for this site. |
permitted | boolean | Sì | Whether the package type includes databases at all. |
can_create | boolean | Sì | `permitted`, **and** the effective ceiling has room. |
Errori che questo endpoint può restituire
401 · 403 · 404 · 429 · 503