hosting
GET /v1/sites/{siteId}/ftp-users
List a site's FTP accounts.
Упълномощаване
Изпратете API ключ като токен за носене. Ключът трябва да притежава разрешението sites.view; ключ без него се отхвърля с 403, а не с 404.
Този ендпойнт не изисква идентификатор на организация. Вашият ключ вече идентифицира организацията, към която принадлежи, и отговорът е ограничен до нея.
Опитайте
Заменете всичко в квадратни скоби със собствени стойности, а ключовия заместващ символ – с ключ от вашето табло за управление.
curl -X GET https://api.zinndigital.com/v1/sites/{siteId}/ftp-users \
-H "Authorization: Bearer zdk_live_…"Влязохте ли в профила си? API конзолата във вашето табло за управление попълва действителното идентификационно число на вашата организация и вашия собствен ключ и изпълнява заявката спрямо реалното API, за да можете да видите действителния отговор. Отворете този крайpoint в API конзолата
Детайли
The FTP accounts on the site's hosting package, including the package's own primary account so the customer can see it exists. No password is returned for any of them, and none can be read back: the vendor does expose the primary account's live credentials in cleartext, and this platform deliberately never calls that endpoint. limit is the effective ceiling — the lower of what the package permits and what the customer bought, with either side being unlimited yielding to the other. permitted and can_create are separate because the screen says different things: "your plan does not include this" is not "you have used all of them". 404 for a site with no vendor hosting package. Requires sites.view.
Параметри
| Име | Тип | Задължително | Какво представлява |
|---|---|---|---|
siteId (path) | Uuid | Да | Site ID (UUIDv7). |
Отговор
| Име | Тип | Задължително | Какво представлява |
|---|---|---|---|
data | SiteFtpUser[] | Да | The accounts on the package, the primary one first. |
limit | VendorAllowance | Да | The effective ceiling on FTP accounts for this site. |
permitted | boolean | Да | Whether the package type includes FTP at all. This is the flag behind "your plan does not include this". |
can_create | boolean | Да | permitted, and the effective ceiling has room. This is the flag behind "you have used all of them". Two fields rather than one because those are different sentences, and a… |
Грешки, които този крайpoint може да върне
401 · 403 · 404 · 429 · 503