员工管理接口
获取企业员工列表
GET https://hub.juzibot.com/api/v1/user/list?token=**¤t=1&pageSize=10
请求参数:
名称 | 类型 | 是否必须 | 备注 |
---|---|---|---|
token | string | 是 | 调用接口凭证 获取方式 |
current | Number | 是 | 当前页数 |
pageSize | Number | 是 | 每页数据条数 |
TIP
- pageSize 每页数据条数, 不能超过1000。
返回示例:
{
errcode: 0,
errmsg: 'ok'
data:[ {
uid: '625f7ad0050d89bfa8637267',
userId: 'zhangsan',
name: '张三',
email: 'zhangsan@163.com',
avatar: 'http://p.qlogo.cn/bizmail/IcsdgagqefergqerhewSdage/0'
}],
total: 100
}
返回参数说明:
名称 | 类型 | 必定存在 | 备注 |
---|---|---|---|
errcode | number | 是 | 返回码 |
errmsg | string | 是 | 对返回码的文本描述内容 |
data | array | 是 | 员工列表 |
data.uid | string | 是 | 组织架构中的员工id, 秒回唯一, 详见uid |
data.userId | string | 是 | 员工userId, 参考wxUserId |
data.name | string | 是 | 员工姓名 |
data.email | string | 否 | 员工邮箱 |
data.avatar | string | 否 | 员工头像 |
total | number | 是 | 员工总数 |
获取成员详情
GET https://hub.juzibot.com/api/v1/user/detail?token=**
请求参数:
名称 | 类型 | 是否必须 | 备注 |
---|---|---|---|
token | string | 是 | 调用接口凭证 获取方式 |
wxUserId | string | 是 | 成员的wxUserId |
返回示例:
{
errcode: 0,
errmsg: 'ok'
data: {
userId: 'zhangsan',
name: '张三',
email: 'zhangsan@163.com',
// isLogin: true,
avatar: 'http://p.qlogo.cn/bizmail/IcsdgagqefergqerhewSdage/0'
}
}
返回参数说明:
名称 | 类型 | 必定存在 | 备注 |
---|---|---|---|
errcode | number | 是 | 返回码 |
errmsg | string | 是 | 对返回码的文本描述内容 |
data | object | 是 | 成员信息 |
data.userId | string | 是 | 员工userId, 参考wxUserId |
data.name | string | 是 | 员工姓名 |
data.email | string | 否 | 员工邮箱 |
data.avatar | string | 否 | 员工头像 |
total | number | 是 | 员工总数 |