Skip to navigation

查詢客戶帳號角色清單

View as Markdown

列出呼叫端所屬租戶可以指派給客戶帳號的角色,用於建立客戶帳號或改派角色前取得合法的 roleId(見 POST /v1/companies/{id}/users)。type 為 Boss、Employee,或租戶自訂角色的 Custom 開頭代碼;只有 Boss 能使用前台的全公司功能。不分頁——一個租戶的角色數量少,建議只查一次並在你端快取。

Authentication

X-Signaturestring

每個 /v1 請求都必須帶 X-Client-Id、X-Timestamp、X-Nonce 與 X-Signature 四個標頭。X-Signature 是以 client secret 對 canonical string 做 HMAC-SHA256 後的 Base64。

canonical string 的組成、可複製的簽章範例與 401 排查步驟,請參閱「驗證與簽章」。

Response

OK
datalist of objects or nullOptional

這個租戶可以指派給客戶帳號的完整角色清單。

Errors

401
Unauthorized Error
403
Forbidden Error
500
Internal Server Error