API 規格後台角色

查詢後台角色清單

View as Markdown

列出呼叫端所屬租戶可以指派給後台使用者的角色，用於建立後台使用者前取得合法的 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 排查步驟，請參閱[「驗證與簽章」](/authentication)。

Response

OK
datalist of objects or nullOptional

這個租戶可以指派給後台使用者的完整角色清單，每一筆為一筆角色資料。

Errors

401
Unauthorized Error
403
Forbidden Error
500
Internal Server Error