hosting
GET /v1/sites/{siteId}/subdomains
List a site's subdomains.
Նույնականացում
Ուղարկեք API բանալին որպես bearer token: Բանալին պետք է ունենա sites.view թույլտվությունը. առանց դրա բանալին մերժվում է 403, և ոչ թե 404 կարգավիճակով:
Այս վերջնակետը կազմակերպության ID չի ընդունում: Ձեր բանալին արդեն իսկ նույնականացնում է այն կազմակերպությունը, որին պատկանում է, և պատասխանը սահմանափակված է դրանով:
Փորձել
Փոխարինեք անկյունային փակագծերում գտնվող ցանկացած բան ձեր սեփական արժեքներով, և բանալու տեղապահը՝ ձեր վահանակի բանալիով:
curl -X GET https://api.zinndigital.com/v1/sites/{siteId}/subdomains \
-H "Authorization: Bearer zdk_live_…"Մուտք գործե՞լ եք: Ձեր վահանակի API վահանակը լրացնում է ձեր իրական կազմակերպության ID-ն և ձեր սեփական բանալին և գործարկում է հարցումը ուղիղ API-ի դեմ, որպեսզի կարողանաք տեսնել փաստացի պատասխանը: Բացեք այս վերջնակետը API վահանակում
Մանրամասներ
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.
Պարամետրեր
| Անուն | Տեսակ | Պահանջվում է | Ինչ է դա |
|---|---|---|---|
siteId (path) | Uuid | Այո | Site ID (UUIDv7). |
Պատասխան
| Անուն | Տեսակ | Պահանջվում է | Ինչ է դա |
|---|---|---|---|
data | SiteSubdomain[] | Այո | The subdomains on the package. |
limit | VendorAllowance | Այո | The effective ceiling on subdomains for this site. |
permitted | boolean | Այո | Whether the package type includes subdomains at all. |
can_create | boolean | Այո | permitted, and the effective ceiling has room. |
used | integer | Ոչ | 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… |
Այս վերջնակետի կողմից վերադարձվող սխալները
401 · 403 · 404 · 429 · 503