查詢後台角色清單
查詢後台角色清單
列出呼叫端所屬租戶可以指派給後台使用者的角色,用於建立後台使用者前取得合法的 roleId(見 POST /v1/internal-users)。不分頁——一個租戶的角色數量少且固定,建議只查一次並在你端快取,不需要每次建立使用者前都重新查詢。
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
data
這個租戶可以指派給後台使用者的完整角色清單,每一筆為一個 InternalRoleResponse。
Errors
401
Unauthorized Error
403
Forbidden Error
500
Internal Server Error