Autentikasi
Kirim kunci API sebagai token bearer. Kunci tersebut harus memiliki izin sites.view; kunci tanpa izin tersebut akan ditolak dengan status 403, bukan 404.
Endpoint ini tidak memerlukan id organisasi. Kunci Anda telah mengidentifikasi organisasi tempatnya berafiliasi, dan respons akan dibatasi untuk organisasi tersebut.
Coba
Ganti apa pun di dalam tanda kurung sudut dengan nilai Anda sendiri, dan placeholder kunci dengan kunci dari dasbor Anda.
curl -X GET https://api.zinndigital.com/v1/sites/{siteId}/subdomains \
-H "Authorization: Bearer zdk_live_…"Sudah masuk? Konsol API di dasbor Anda akan mengisi ID organisasi asli dan kunci Anda sendiri, serta menjalankan permintaan terhadap API langsung sehingga Anda dapat melihat respons aktualnya. Buka titik akhir ini di konsol API
Detail
The subdomains served by the site's hosting package and the document root each one points at. ⛔ Subdomains are the only surface here with a real **quantity** ceiling: `limit` is the lower of what the package template permits and what the customer bought, so `can_create` is arithmetic and not merely `permitted`. ⚖️ **On our own fleet the ceiling is the plan's `max_sites`, because a subdomain spends one of them** (owner ruling 2026-09-01). `limit` is then the site cap and `used` carries how much of it is already spent — by the customer's **sites as well as their subdomains** — so a client must render the caption from `used` and not from `data.length`. On the resold line `used` is absent and counting the rows is correct; nothing else about the shape differs. Requires `sites.view`. `404` for a site with no managed hosting package and no own-fleet placement.
Parameter
| Nama | Jenis | Wajib | Tentang apa ini |
|---|---|---|---|
siteId (path) | Uuid | Ya | Site ID (UUIDv7). |
Tanggapan
| Nama | Jenis | Wajib | Tentang apa ini |
|---|---|---|---|
data | SiteSubdomain[] | Ya | The subdomains on the package. |
limit | VendorAllowance | Ya | The effective ceiling on subdomains for this site. |
permitted | boolean | Ya | Whether the package type includes subdomains at all. |
can_create | boolean | Ya | `permitted`, **and** the effective ceiling has room. |
used | integer | Tidak | How much of `limit` is already spent, when that is **not** `data.length`. ⚖️ Present only on our own fleet, where a subdomain consumes one of the plan's `max_sites` slots (owner… |
Kesalahan yang dapat dikembalikan oleh titik akhir ini
401 · 403 · 404 · 429 · 503