hosting
GET /v1/sites/{siteId}/ftp-users
List a site's FTP accounts.
Նույնականացում
Ուղարկեք API բանալին որպես bearer token: Բանալին պետք է ունենա sites.view թույլտվությունը. առանց դրա բանալին մերժվում է 403, և ոչ թե 404 կարգավիճակով:
Այս վերջնակետը կազմակերպության ID չի ընդունում: Ձեր բանալին արդեն իսկ նույնականացնում է այն կազմակերպությունը, որին պատկանում է, և պատասխանը սահմանափակված է դրանով:
Փորձել
Փոխարինեք անկյունային փակագծերում գտնվող ցանկացած բան ձեր սեփական արժեքներով, և բանալու տեղապահը՝ ձեր վահանակի բանալիով:
curl -X GET https://api.zinndigital.com/v1/sites/{siteId}/ftp-users \
-H "Authorization: Bearer zdk_live_…"Մուտք գործե՞լ եք: Ձեր վահանակի API վահանակը լրացնում է ձեր իրական կազմակերպության ID-ն և ձեր սեփական բանալին և գործարկում է հարցումը ուղիղ API-ի դեմ, որպեսզի կարողանաք տեսնել փաստացի պատասխանը: Բացեք այս վերջնակետը 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… |
Այս վերջնակետի կողմից վերադարձվող սխալները
401 · 403 · 404 · 429 · 503