文档中心 员工接口 查询员工

查询员工

1.功能说明

根据工号、手机号或者邮箱等查询企业平台下的在职员工信息

2.接口调用说明

请求URL

https://openapi.guanaitong.tech/employee/get

HTTP请求方式

POST

application/x-www-form-urlencoded

输入参数说明

(1)公共参数

发送请求是必须传入公共参数,详见公共参数

(2)私有参数

参数名称 是否必须 参数类型 长度限制 描述
corp_code string [1,20] 员工工号。工号、userid、手机号和邮箱,三个参数同步一个
userid string [1,100] 员工第三方唯一标识
enterprise_code string [1,20] 企业编号(集团和运营商同步,企业不填)
mobile_area int [1,10] 手机号区号
mobile string [6,20] 员工绑定手机号
email string [1,100] 员工绑定邮箱
请求示例
POST /employee/get HTTP/1.1
Host: openapi.guanaitong.tech
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache

access_token=a9574640d1030306d684706ecbf5d84f&corp_code=LOL001&
timestamp=1492671874&sign=b314c43d96345a364c65c982ef1c95ab55fa3482
                    
返回参数说明
参数名称 描述
code 返回码。详见错误返回码
msg 如果错误,返回错误信息。
data 如果没有错误,返回业务数据
data.corp_code 员工工号
data.name 员工姓名
data.gender 员工性别
data.card_type 证件类型
data.card_no 证件号码
data.email 邮箱
data.mobile_area 手机区号
data.mobile 手机号
data.remark 备注
data.dept_code 部门编号
data.dept_name 部门名称
data.level 员工分级(需先在企业后台开启该功能,否则返回null)
data.category 员工分类(需先在企业后台开启该功能,否则返回null)
data.birth_day 生日,格式为yyyy-MM-dd
data.entry_day 入职日期,格式为yyyy-MM-dd
data.time_created 注册日期
data.time_active 激活日期(首次登陆日期)
正确返回示例
{
    "code":0,
    "data":{
        "corp_code":"LOL001",
        "name":"测试641",
        "gender":3,
        "mobile_area":86,
        "mobile":"13611111111",
        "email":null
        "level":"1级",
        "category":[],
        "remark":"你是备注",
        "card_type":0,
        "card_no":null,
        "dept_code":"XXX有限公司",
        "dept_name":"XXX有限公司",
        "birth_day":"1990-01-01",
        "entry_day":null,
        "time_created":"2018-10-18",
        "time_active":null,
    },
    "msg":"OK"
}
错误返回示例
{
    "code": 1000210004,
    "data": null,
    "msg": "tokeninfo check failed!"
}