获取调用此API的账号所能管理的角色。
说明
- 管理员角色调用返回:管理员/技能组组长/坐席
- 技能组组长角色调用返回:技能组组长/坐席
- 坐席角色调用返回:坐席
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListRoles |
系统规定参数。取值:ListRoles。 |
InstanceId | String | 是 | 9cfad875-6260-4a53-ab6e-b13e3fb31f7d |
待获取角色列表的呼叫中心实例的ID |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Code | String | OK |
响应码 |
HttpStatusCode | Integer | 200 |
HTTP状态码 |
Message | String | 无 |
响应信息 |
RequestId | String | 711D948F-C616-4E23-8573-0F260513CE09 |
请求ID |
Roles |
一个呼叫中心实例的所有角色列表 |
||
Role |
一个呼叫中心实例的所有角色列表 |
||
InstanceId | String | 9cfad875-6260-4a53-ab6e-b13e3fb31f7d |
角色所归属的呼叫中心实例 |
RoleDescription | String | 技能组组长 |
角色描述 |
RoleId | String | 42d97cec-386b-4770-ad7b-0e6a4e665c74 |
角色ID,系统自动生成的唯一标示符 |
RoleName | String | SKILL_GROUP_ADMIN |
角色名称 |
Success | Boolean | true |
是否成功 |
示例
请求示例
http(s)://ccc.cn-shanghai.aliyuncs.com/?Action=ListRoles
&InstanceId=9cfad875-6260-4a53-ab6e-b13e3fb31f7d
&<公共请求参数>
正常返回示例
XML
格式
<ListRolesResponse>
<HttpStatusCode>200</HttpStatusCode>
<RequestId>711D948F-C616-4E23-8573-0F260513CE09</RequestId>
<Success>true</Success>
<Code>OK</Code>
<Roles>
<Role>
<RoleName>SKILL_GROUP_ADMIN</RoleName>
<InstanceId>9cfad875-6260-4a53-ab6e-b13e3fb31f7d</InstanceId>
<RoleDescription>技能组组长</RoleDescription>
<RoleId>42d97cec-386b-4770-ad7b-0e6a4e665c74</RoleId>
</Role>
<Role>
<RoleName>AGENT</RoleName>
<InstanceId>9cfad875-6260-4a53-ab6e-b13e3fb31f7d</InstanceId>
<RoleDescription>坐席</RoleDescription>
<RoleId>4c2e158e-ddd9-464a-a3fc-338eca10277c</RoleId>
</Role>
<Role>
<RoleName>ADMIN</RoleName>
<InstanceId>9cfad875-6260-4a53-ab6e-b13e3fb31f7d</InstanceId>
<RoleDescription>管理员</RoleDescription>
<RoleId>59a3d864-2f98-4f5e-84ec-c1ea13af93f3</RoleId>
</Role>
</Roles>
</ListRolesResponse>
JSON
格式
{
"HttpStatusCode":200,
"RequestId":"711D948F-C616-4E23-8573-0F260513CE09",
"Success":true,
"Code":"OK",
"Roles":{
"Role":[
{
"RoleName":"SKILL_GROUP_ADMIN",
"InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
"RoleDescription":"技能组组长",
"RoleId":"42d97cec-386b-4770-ad7b-0e6a4e665c74"
},
{
"RoleName":"AGENT",
"InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
"RoleDescription":"坐席",
"RoleId":"4c2e158e-ddd9-464a-a3fc-338eca10277c"
},
{
"RoleName":"ADMIN",
"InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
"RoleDescription":"管理员",
"RoleId":"59a3d864-2f98-4f5e-84ec-c1ea13af93f3"
}
]
}
}
错误码
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交