hosting
GET /v1/sites/{siteId}/resource-usage
Get the vendor's own counts of what a package is using.
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}/resource-usage \
-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
How many cron jobs, FTP accounts, databases, database users, aliases and SSH keys the package currently holds, counted by the vendor rather than by us. This is the honest denominator behind every *"3 of 5"* caption on the hosting tab: a count we derived from our own list would disagree with the package the moment anything was created outside this platform. ⛔ A count the vendor sent in a form we could not read is **named in `unreadable`** and reported as `0`, never silently folded into the number. A caption built on a zero that means "we could not tell" is worse than no caption. Requires `sites.view` — the same class of fact as the disk and bandwidth figures beside it. `404` for a site with no managed hosting package.
Parametri
| Nome | Tipo | Obbligatorio | Che cos'è |
|---|---|---|---|
siteId (path) | Uuid | Sì | Site ID (UUIDv7). |
Risposta
| Nome | Tipo | Obbligatorio | Che cos'è |
|---|---|---|---|
cron_jobs | integer | Sì | Scheduled tasks on the package. |
ftp_accounts | integer | Sì | FTP accounts on the package, including its primary one. |
mysql_databases | integer | Sì | MySQL databases on the package. |
mysql_users | integer | Sì | MySQL users on the package. |
server_aliases | integer | Sì | Domain aliases pointed at the package. |
ssh_public_keys | integer | Sì | SSH public keys installed on the package. |
unreadable | string[] | Sì | ⛔ Counts the vendor sent in a form we could not read. They are **named here and reported as 0** above, never silently folded into the number — a caption built on a zero that mea… |
Errori che questo endpoint può restituire
401 · 403 · 404 · 429 · 503