副使用者管理 | 鑽石託管 DiamondHost

BASE URLhttps://panel.diamondhost.tw/api/client/servers/{server}/users

GET/

列出副使用者

回傳所有副使用者及其目前擁有的權限。

程式範例cURL / Node.js / Python

curl -X GET "${BASE_URL}/" \
  -H "Authorization: Bearer ${API_KEY}" \
  -H "Accept: application/json"

POST/

新增副使用者

以電子郵件邀請使用者並授予指定權限。

REQUEST BODY

{
  "email": "developer@example.com",
  "permissions": ["control.console", "control.start", "file.read"]
}

程式範例cURL / Node.js / Python

curl -X POST "${BASE_URL}/" \
  -H "Authorization: Bearer ${API_KEY}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "email": "developer@example.com",
  "permissions": ["control.console", "control.start", "file.read"]
}'

POST/{user}

更新權限

以新的 permissions 陣列取代副使用者目前權限。

REQUEST BODY

{
  "permissions": ["control.console", "control.start", "control.stop", "file.read"]
}

程式範例cURL / Node.js / Python

curl -X POST "${BASE_URL}/{user}" \
  -H "Authorization: Bearer ${API_KEY}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "permissions": ["control.console", "control.start", "control.stop", "file.read"]
}'

DELETE/{user}

移除副使用者

撤銷指定使用者對伺服器的所有存取權。

程式範例cURL / Node.js / Python

curl -X DELETE "${BASE_URL}/{user}" \
  -H "Authorization: Bearer ${API_KEY}" \
  -H "Accept: application/json"