hosting
GET /v1/sites/{siteId}/hosting/usage
Get a site's current-period hosting usage.
Аутентификација
Пошаљите API кључ као bearer токен. Кључ мора имати дозволу sites.view; кључ без ње се одбија уз 403, а не 404.
Ова крајња тачка не прихвата id организације. Ваш кључ већ идентификује организацију којој припада, а одговор је ограничен на њу.
Испробајте
Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.
curl -X GET https://api.zinndigital.com/v1/sites/{siteId}/hosting/usage \
-H "Authorization: Bearer zdk_live_…"Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли
Детаљи
Disk and outbound bandwidth for the site's package this period, read from the vendor — the same figures the metering basis uses (docs/62 §3.4). Inbound bytes are deliberately not reported: billing a customer for what was sent to their site would charge them for other people's traffic, including an attack. periods carries the daily/monthly/yearly series where the vendor publishes it, and is empty otherwise rather than fabricated. 404 for a site with no vendor package. Requires sites.view.
Параметри
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
siteId (path) | Uuid | Да | Site ID (UUIDv7). |
Одговор
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
disk_used_mb | integer | Да | Disk used this period, in MB. |
bandwidth_mb | integer | Да | Outbound bandwidth this period, in MB. Inbound is never billed or shown. |
requests | integer | Да | Hits this period, as the vendor counts them. |
periods | object | Да | Daily / monthly / yearly hit and byte totals where the vendor publishes them; empty otherwise, never fabricated. |
Грешке које ова крајња тачка може вратити
401 · 403 · 404 · 429 · 503