简体中文
获取角色列表
约 281 字小于 1 分钟
2026-01-16
描述
获取角色列表
请求说明
请求方式:POST + application/json
请求路径:https://${填入所在云的域名}/cgi/crm/v2/special/roleGetRoleList?thirdTraceId=${随机字符串}
请求头填写 :参考公共参数填写
请求参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| includeNull | Boolean | 否 | 是否包含 null 字段,false:不返回,true:返回,不传默认为false |
| data | Map | 是 | 数据集 |
| AuthContext | Map | 是 | 应用信息 |
| appId | String | 是 | 应用id |
请求示例
{
"includeNull": true,
"data": {
"AuthContext": {
"appId": "CRM"
}
}
}返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| traceId | string | 请求唯一ID |
| errorDescription | string | 错误描述 |
| errorMessage | string | 错误信息 |
| errorCode | Int | 查看错误码 |
| data | List | 数据集 |
返回示例
{
"traceId": "E-O.827xxxxxx",
"errorDescription": "success",
"errorMessage": "OK",
"errorCode": 0,
"data": [
{
"groupName": "销售角色",
"roleCode": "00000000000000001",
"roleName": "销售人员",
"roleType": 1,
"appId": "CRM",
"description": "销售人员预设销售相关功能权限",
"delFlag": false
},
{
"groupName": "财务角色",
"roleCode": "00000000000002",
"roleName": "退款财务",
"roleType": 1,
"appId": "CRM",
"description": "退款财务相关权限",
"delFlag": false
}
]
}注意事项
- 不能使用返回值的message字段做逻辑判断,errorMessage会有变化;
