hosting
GET /v1/hosting/locations
List the data centres a new site may be created in.
Упълномощаване
Изпратете API ключ като носител (bearer token). Тази точка за достъп не указва конкретно разрешение в спецификацията, затова дайте на ключа си най-малкото необходимо и проверете отговора, вместо да правите предположения.
Този ендпойнт не изисква идентификатор на организация. Вашият ключ вече идентифицира организацията, към която принадлежи, и отговорът е ограничен до нея.
Опитайте
Заменете всичко в квадратни скоби със собствени стойности, а ключовия заместващ символ – с ключ от вашето табло за управление.
curl -X GET https://api.zinndigital.com/v1/hosting/locations \
-H "Authorization: Bearer zdk_live_…"Влязохте ли в профила си? API конзолата във вашето табло за управление попълва действителното идентификационно число на вашата организация и вашия собствен ключ и изпълнява заявката спрямо реалното API, за да можете да видите действителния отговор. Отворете този крайpoint в API конзолата
Детайли
Every data centre a new site may be placed in, across both estates (docs/370): the locations this platform has activated for the managed hosting range (docs/62 §3.5), plus the regions of our own fleet that currently have a worker able to take the site. Activating a managed-range location is a reseller-level purchase — activate once, host unlimited sites in it — and a fleet region is available whenever a box there is active, accepting deploys and not full. The answer carries no tenant scope; it is authenticated only because it describes our estate rather than being marketing copy. An empty list is a real answer, not an error: nothing is activated and no fleet worker can take the site, a managed-range location could not be pinned with the configuration present, or the line is one we do not offer a choice on. The client must then hide the picker and let the default placement apply — it must never substitute a list of its own, because creating a site in a location we have not activated is refused by the vendor after the customer has chosen, and a fleet region with no box behind it fails in placement for the same reason. code is the placement identifier (lhr, nbg1) and the suffix of the i18n key the client renders; country is ISO-3166 alpha-2 for a decorative flag. There is deliberately no display name — location names are translated like every other user-facing string, and a flag is never the accessible name.
Параметри
| Име | Тип | Задължително | Какво представлява |
|---|---|---|---|
product_line (query) | string | Не | Narrow the answer to the lines a site of this product line could be placed on. A fleet region is offered only when a worker serving this line has capacity, and the… |
Отговор
| Име | Тип | Задължително | Какво представлява |
|---|---|---|---|
data | DataCentreLocation[] | Да | — |
Грешки, които този крайpoint може да върне
401 · 429