同步角色
场景描述
将工单角色同步至CRM。
接口方法
Post
接口URI
https://域名/apiaccess/rest/sum/v1/tenantSpaces/roles/users，例如域名是service.besclouds.com。
请求说明
序号 |
名称 |
参数类型 |
是否必选 |
说明 |
|---|---|---|---|---|
1 |
X-APP-Key |
string |
False |
appKey字段，用户标识，请联系运营人员获取appKey。 |
2 |
Authorization |
string |
True |
鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格）。 生成方式参见文档C1 系统配置类接口鉴权方式式章节。 |
3 |
Content-Type |
string |
False |
"application/json" |
序号 |
参数 |
是否必选 |
类型 |
描述 |
1 |
requestBody [] |
是 |
UserRoles |
用户角色，支持批量处理，数组最大支持999。 |
1.1 |
actionType |
是 |
String |
操作类型： Grant：分配权限 Revoke：取消权限 |
1.2 |
userId |
是 |
String |
用户标识id。 |
1.3 |
roleId |
是 |
String |
角色标识id。 |
响应说明
- 响应状态码: 200
表3 响应体参数 序号
名称
参数类型
说明
2
resCode
string
错误码。取值如下：
0：成功
非0：失败
3
resMsg
string
- success
- fail
4
result
Object
查询成功后，返回结果信息的对象。
表4 Result对象 序号
参数
类型
描述
1
agentRoleId
String
系统产生的租户角色唯一标识。
错误码
- 响应状态码: 400
错误的请求：请检查请求路径及参数。
- 响应状态码: 401
未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。
- 响应状态码: 403
鉴权失败。
- 响应状态码: 404
请求的内容未找到：请检查请求的路径。
- 响应状态码: 500
业务失败：请依次确认您请求中各参数的取值。
报文样例
场景描述：同步角色
URL：https://域名/apiaccess/rest/sum/v1/tenantSpaces/roles/users
- 请求头
x-app-key:953587d812f642998ee1f633b81212f3 Authorization:Bearer e3fca9398eaa5cef4b57b523b9c75fae Content-Type:application/json
- 请求消息:
{
"requestBody": [{
"actionType": "Grant",
"userId": "10gg0000015C8wfbgWbg",
"roleId": "cH9k0000019M3qH6PKFM"
},
{
"actionType": "Grant",
"userId": "10gg0000015C8wfbgWbg",
"roleId": "cH9k0000019AIu9XwdHc"
}
]}
- 响应消息:
{
"resCode": "0",
"resMsg": "success",
"result": {
"agentRoleId": []
}
}
