hosting

GET /v1/sites/{siteId}/ftp-users

List a site's FTP accounts.

Всички крайни точки в hosting

Упълномощаване

Изпратете 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).

Отговор

ИмеТипЗадължителноКакво представлява
dataSiteFtpUser[]ДаThe accounts on the package, the primary one first.
limitVendorAllowanceДаThe effective ceiling on FTP accounts for this site.
permittedbooleanДаWhether the package type includes FTP at all. This is the flag behind *"your plan does not include this"*.
can_createbooleanДа`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…

Грешки, които този крайpoint може да върне

401 · 403 · 404 · 429 · 503