坐席详情列表
服务描述
本接口可获取当前租户下坐席的详情列表。
开发须知
调用本接口前,请先获取appId
服务地址
GET https://{您的专属域名}/basic/openapi/v1/staff/getSubUser
请求参数
参数 |
位置 |
类型 |
是否必填 |
说明 |
appId |
header |
String |
Y |
应用ID |
timestamp |
header |
String |
Y |
时间戳,毫秒 |
sign |
header |
String |
Y |
签名 |
Content-Type |
header |
String |
Y |
application/json |
userIds |
url参数 |
String[] |
N |
坐席IDS |
请求数据示例:
GET https://{您的专属域名}/basic/openapi/v1/staff/getSubUser
返回结果
UserInfoDTOExt
参数 |
类型 |
说明 |
id |
Long |
坐席id |
phone |
String |
电话号码 |
email |
String |
邮箱 |
name |
String |
名称 |
nickname |
String |
昵称 |
empno |
String |
工号 |
status |
Byte |
坐席状态:0:禁用,1:启用,2:审核中 |
isLock |
Boolean |
是否锁定:0-否,1-是 |
tenantId |
String |
坐席所属租户ID |
parentId |
Long |
坐席的父ID |
lastLogintime |
Date |
最后登录时间 |
createTime |
Date |
创建时间 |
roles |
List<BasicRole> |
坐席拥有角色 |
departments |
List<BasicDepartment> |
坐席所属部门 |
BasicRole
参数 |
类型 |
说明 |
id |
Long |
角色id |
name |
String |
角色名称 |
BasicDepartment
参数 |
类型 |
说明 |
id |
Long |
部门id |
name |
String |
部门名称 |
返回结果示例:
{
"code": "10000",
"message": "请求成功",
"data": [
{
"email": "mingliang.qi@msxf.com",
"roles": [
{
"id": 455,
"name": "管理员"
}
],
"id": 19899790,
"phone": "12345642121",
"name": "漆明亮",
"nickname": "漆明亮",
"empno": "100893",
"departments": [
{
"id": 19,
"name": "采购部x"
}
],
"status": 1,
"isLock": false,
"lastLogintime": "2021-06-24T11:27:02.000+0800",
"tenantId": "msxf1524664727417005e005f",
"createTime": "2021-05-25T01:12:57.000+0800",
"parentId": 1
},
{
"email": "qingsong.tian@msxf.com",
"roles": [
{
"id": 455,
"name": "管理员"
}
],
"id": 19899791,
"phone": "18612341234",
"name": "田青松",
"nickname": "田青松",
"empno": "1234444",
"departments": [],
"status": 1,
"isLock": false,
"lastLogintime": "2021-06-28T14:11:14.000+0800",
"tenantId": "msxf1524664727417005e005f",
"createTime": "2021-05-25T22:08:28.000+0800",
"parentId": 1
},
{
"email": "zeren.wu@msxf.com",
"roles": [
{
"id": 455,
"name": "管理员"
}
],
"id": 19899792,
"phone": "18612343412",
"name": "吴择任",
"nickname": "吴择任",
"empno": "1233444",
"departments": [],
"status": 1,
"isLock": false,
"lastLogintime": "2021-06-28T13:42:20.000+0800",
"tenantId": "msxf1524664727417005e005f",
"createTime": "2021-05-25T22:10:12.000+0800",
"parentId": 1
}
]
}
结果码说明
结果码 |
说明 |
10000 |
请求成功 |
20001 |
请求失败 |
21002 |
认证失败,请重新登录 |
FAQ: