员工信息查询¶
功能说明¶
根据员工标识查询企业平台下的在职员工信息
接口地址¶
- 测试环境: https://openapi.guanaitong.tech/tenant/enterprise/employee/get
- 生产环境: https://openapi.guanaitong.com/tenant/enterprise/employee/get
参数说明¶
-
公有参数
发送请求是必须传入公共参数,详见公共参数
-
私有参数
| 参数名称 | 是否必须 | 参数类型 | 长度限制 | 描述 |
|---|---|---|---|---|
| user_id | 是 | string | [1,20] | 员工唯一标识 |
| enterprise_id | 是 | int | 企业编码 |
请求示例¶
POST /tenant/enterprise/employee/get HTTP/1.1
Host: openapi.guanaitong.tech
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache
access_token=a9574640d1030306d684706ecbf5d84f&user_id=LOL001&enterprise_id=1234×tamp=1492671874&sign=b314c43d96345a364c65c982ef1c95ab55fa3482
返回参数说明¶
| 参数名称 | 描述 |
|---|---|
| code | 返回码。详见错误返回码。 |
| msg | 如果错误,返回错误信息。 |
| data | 如果没有错误,返回业务数据 |
| data.user_id | 员工标识 |
| data.name | 员工姓名 |
| data.gender | 员工性别 |
| data.email | 邮箱 |
| data.mobile_area | 手机区号 |
| data.mobile | 手机号 |
| 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,
"birth_day":"1990-01-01",
"entry_day":null,
"time_created":"2018-10-18",
"time_active":null,
},
"msg":"OK"
}