hosting

GET /v1/sites/{siteId}/subdomains

List a site's subdomains.

Tüm hosting uç noktaları

Kimlik Doğrulama

Bearer token olarak bir API anahtarı gönderin. Anahtar sites.view iznine sahip olmalıdır; bu izne sahip olmayan bir anahtar 404 ile değil, 403 ile reddedilir.

Bu uç nokta hiçbir organizasyon kimliği almaz. Anahtarınız zaten ait olduğu organizasyonu tanımlar ve yanıt bu organizasyonla sınırlandırılır.

Dene

Köşeli parantez içindeki her şeyi kendi değerlerinizle ve anahtar yer tutucusunu panonuzdan bir anahtarla değiştirin.

curl -X GET https://api.zinndigital.com/v1/sites/{siteId}/subdomains \
  -H "Authorization: Bearer zdk_live_…"

Oturum açtınız mı? Panonuzdaki API konsolu, gerçek organizasyon kimliğinizi ve kendi anahtarınızı otomatik olarak doldurur ve isteği canlı API üzerinde çalıştırarak gerçek yanıtı görmenizi sağlar. Bu uç noktayı API konsolunda açın

Ayrıntılar

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.

Parametreler

AdTürZorunluNe olduğu
siteId (path)UuidEvetSite ID (UUIDv7).

Yanıt

AdTürZorunluNe olduğu
dataSiteSubdomain[]EvetThe subdomains on the package.
limitVendorAllowanceEvetThe effective ceiling on subdomains for this site.
permittedbooleanEvetWhether the package type includes subdomains at all.
can_createbooleanEvet`permitted`, **and** the effective ceiling has room.
usedintegerHayırHow 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…

Bu uç noktanın dönderebileceği hatalar

401 · 403 · 404 · 429 · 503