This document is written in Chinese. Due to the limited ability of the author, there may be some unclear expressions in the English document. Users can discuss with us immediately to avoid misunderstanding.
[EN]

简要描述:

  • 员工信息获取接口
    提供以下2种方式获取:
  1. 使用企业微信官方接口:较简单,限制较多
  2. 使用自建系统:较负载,扩展性强,但需客户方有相应开发能力

    方式一:企业微信接口

    接口版本:

版本号 制定人 制定日期 修订日期
0.1 王鹤 2018-12-18

步骤一:获取企业access_token

在取得企业的永久授权码后,我方将通过此接口获取到企业的access_token。

请求URL:
请求方式:
  • POST
参数说明:
参数名 是否必须 说明
corpid 企业ID
corpsecret 应用的凭证密钥
返回示例:

正确时返回:

{
   "errcode":0"errmsg":"""access_token": "accesstoken000001",
   "expires_in": 7200
}

错误时返回:

{
   "errcode":40091,
   "errmsg":"secret is invalid"
}
返回参数说明:
参数名 说明
access_token 获取到的凭证,最长为512字节
expires_in 凭证的有效时间(秒)
备注:
  • 我方将缓存此access_token,待其过期后重新获取。

步骤二:获取成员列表(手动执行)

此操作用于获取部门内所有成员列表,为避免权限滥用,应限制我方账号尽可获取授权部门通讯录信息,同时,为避免频繁请求数据,此步骤不建议自动执行,(实际使用中,人员增减不会太过频繁),应在每次人员变更后,在后台手动执行获取成员列表操作。
对于新增人员,将自动触发下一步操作,对于删除人员,将自动将其离职。

请求URL:
请求方式:
  • GET
参数说明:
参数名 是否必须 说明
access_token 调用接口凭证
department_id 获取的部门id
fetch_child 1/0:是否递归获取子部门下面的成员
返回示例:

正确时返回:

{
   "errcode": 0,
   "errmsg": "ok",
   "userlist": [
           {
                  "userid": "zhangsan",
                  "name": "李四",
                  "department": [1, 2]
           }
     ]
}
返回参数说明:
参数名 说明
errcode 返回码
errmsg 对返回码的文本描述内容
userlist 成员列表
Worknumber 成员员工编号
name 成员名称
department 成员所属部门
备注:
  • 以上数据仅供参考,具体字段,会根据实际业务调整。

步骤三:获取成员详细信息

此操作用于获取成员详细信息,会通过定时任务的形式,自动获取,暂定为每日3:00,系统自动更新所有成员信息。此操作同样支持手动刷新。

请求URL:
请求方式:
  • GET
参数说明:
参数名 是否必须 说明
access_token 调用接口凭证
Worknumber 成员UserID。对应管理端的帐号,企业内必须唯一。不区分大小写,长度为1~64个字节
返回示例:

正确时返回:

{
    "errcode": 0,
    "errmsg": "ok",
    "Worknumber": "W20078277",
    "username": "李四",
    "phone": "13752299015",
    "department": [1, 2],
    "avatarUrl": null,
    "batch": "SH 20181015"
    "counter": "Tianjin Hisense",
    "createtime": "1539159953",
    "date": "2018-10-15",
    "nickName": 小四,
    "openid": null,
}
返回参数说明:
参数名 说明
errcode 返回码
errmsg 对返回码的文本描述内容
Worknumber 成员员工编号
username 成员名称
phone 手机号码,同时用于员工登陆
department 成员所属部门id列表
avatarUrl 头像地址
batch 批次
counter 柜台
createtime 首次访问时间,以unix时间戳记录
date 入职时间,以2018-10-15形式记录
nickName 微信昵称
openid 微信openid
备注:
  • 以上数据仅供参考,具体字段,会根据实际业务调整。

方式二:自建HR体系

类似微信接口,但具体应双方相关接口、参数,或客户方提供标准接口,我方直接调用获取。

文档更新时间: 2018-12-28 16:59   作者:admin