留言、咨询与反馈
我们会在1个工作日内和您联系（工作时间 周一至周五 9:00-18:00）
留言、咨询与反馈
请填写联系方式 
查询员工信息
1. 根据Id查询员工信息
请求说明
请求方式：post+application/json 方式
请求路径：https://open.71360.com/cgi/user/get
参数说明
| 参数 | 参数类型 | 必须 | 说明 |
|---|---|---|---|
| corpAccessToken | String | 是 | 企业应用访问公司合法性凭证 |
| corpId | String | 是 | 开放平台公司帐号 |
| openUserId | String | 是 | 开放平台员工帐号 |
| showDepartmentIdsDetail | boolean | 否 | 如果为true，则会返回员工主属部门(mainDepartmentId)与附属部门(attachingDepartmentIds); 默认值为false |
请求包结构体示例：
{
"corpAccessToken": "CORP_ACCESS_TOKEN",
"corpId": "CORP_ID",
"openUserId": "OPEN_USER_ID"
}返回说明
| 参数 | 必须 | 说明 |
|---|---|---|
| errorCode | 是 | 返回码 |
| errorMessage | 是 | 对返回码的文本描述内容 |
| openUserId | 否 | 开放平台员工帐号 |
| account | 否 | 员工账号 |
| name | 否 | 员工姓名 |
| nickName | 否 | 员工昵称 |
| isStop | 否 | 员工状态，如果为true,则表示此员工状态为停用，否则，员工状态为启用 |
| 否 | 邮箱 | |
| mobile | 否 | 手机号 |
| gender | 否 | 员工性别：M(男) F(女) |
| position | 否 | 员工职位 |
| profileImageUrl | 否 | 头像文件ID |
| departmentIds | 否 | 员工所属部门及其父部门ID列表 |
| mainDepartmentId | 否 | 员工主属部门ID |
| attachingDepartmentIds | 否 | 员工附属部门ID列表 |
| employeeNumber | 否 | 员工编号 |
| hireDate | 否 | 入职日期 |
| birthDate | 否 | 员工生日 |
| startWorkDate | 否 | 参加工作日期 |
| createTime | 否 | 创建时间 |
| leaderId | 否 | 汇报对象 |
a) 正确的JSON返回结果示例:
{
"openUserId": "FSUID_XXXXXXXXXXXXXXXXXXX",
"account": "Andson",
"name": "Andson",
"nickName": "Andy",
"isStop": false,
"mobile": "18210000000",
"gender": "M",
"position": "PM",
"profileImageUrl": "201502_09_99aa47b5-1f3d-4473-8c02-3d69a6769e57",
"departmentIds": [
44,
13
],
"employeeNumber": "168XXX002",
"hireDate": "2016/08/31",
"birthDate": "1989/09/05",
"startWorkDate": "2008-08-31",
"createTime": 1504547315500,
"leaderId": "FSUID_XXXXXXXXXXXXXXXXXX",
"errorCode": 0,
"errorMessage": "success"
}b) 错误的JSON返回示例:
{
"errorCode": 10001,
"errorMessage": "the parameter appId is missing"
}2. 根据昵称查询员工信息
请求说明
请求方式：post+application/json 方式
请求路径：https://open.71360.com/cgi/user/getByNickName
参数说明
| 参数 | 参数类型 | 必须 | 说明 |
|---|---|---|---|
| corpAccessToken | String | 是 | 企业应用访问公司合法性凭证 |
| corpId | String | 是 | 开放平台公司帐号 |
| nickName | String | 是 | 员工昵称 |
请求包结构体示例：
{
"corpAccessToken": "CORP_ACCESS_TOKEN",
"corpId": "CORP_ID",
"nickName": "张三"
}返回说明
| 参数 | 必须 | 说明 |
|---|---|---|
| errorCode | 是 | 返回码 |
| errorMessage | 是 | 对返回码的文本描述内容 |
| errorDescription | 否 | 返回码的中文描述 |
| empList | 否 | 返回结果列表 |
| enterpriseId | 否 | 企业ei |
| openUserId | 否 | 开放平台员工账号 |
| account | 否 | 员工账号 |
| fullName | 否 | 员工姓名 |
| name | 否 | 员工昵称 |
| status | 否 | 员工状态 |
| mobile | 否 | 员工手机号 |
| leaderId | 否 | 汇报对象开平账号 |
| telephone | 否 | 电话号码 |
| role | 否 | 角色 |
| post | 否 | 职位 |
| 否 | qq | |
| email | 否 | 邮箱 |
| gender | 否 | 员工性别：M(男) F(女) |
| profileImage | 否 | 头像 |
| description | 否 | 描述 |
| weixin | 否 | 微信账号 |
| msn | 否 | msn |
| extensionNumber | 否 | extensionNumber |
| mobileSetting | 否 | 手机号隐私 |
| workingState | 否 | workingState |
| isActive | 否 | 激活状态 |
| mainDepartmentIds | 否 | 主属部门 |
| departmentIds | 否 | 所有所属部门（包括主属部门） |
| departmentAsteriskIds | 否 | 星标部门 |
| employeeAsteriskIds | 否 | 星标员工 |
| birthDate | 否 | 生日 |
| hireDate | 否 | 入职时间 |
| empNum | 否 | 员工编号 |
| startWorkDate | 否 | 就业时间 |
| stopTime | 否 | 停用时间 |
| createTime | 否 | 创建时间 |
| updateTime | 否 | 更新时间 |
| nameSpell | 否 | nameSpell |
| nameOrder | 否 | nameOrder |
a) 正确的JSON返回结果示例:
{
"empList": [
{
"enterpriseId": 590079,
"openUserId": "FSUID_69AF29A7AA695787C90614CDDE0A4968",
"account": "",
"fullName": "",
"name": "张三",
"status": "NORMAL",
"mobile": "17328366613",
"leaderId": "FSUID_6D3F8498206FD5F8B2E0559AED7737E1",
"telephone": "",
"role": "DEFAULT",
"post": "",
"qq": "",
"email": "",
"gender": "M",
"profileImage": "",
"description": "",
"weixin": "12342321111",
"msn": "",
"extensionNumber": "",
"mobileSetting": {
"mobileStatus": "PUBLIC",
"departmentIds": [],
"employeeIds": []
},
"workingState": "",
"isActive": true,
"mainDepartmentIds": [
1000
],
"departmentIds": [
1000
],
"departmentAsteriskIds": [],
"employeeAsteriskIds": [],
"birthDate": "",
"hireDate": "2018-06-27",
"empNum": "",
"startWorkDate": "",
"stopTime": 0,
"createTime": 1530083843500,
"updateTime": 1542036068500,
"nameSpell": "HUANGZHI",
"nameOrder": "H#BBC6#D6C7"
}
],
"errorCode": 0,
"errorMessage": "success",
"errorDescription": "成功"
}b) 错误的JSON返回示例:
{
"errorCode": 20017,
"errorMessage": "openCorpId not found"
}3. 根据手机号查询员工信息
请求说明
请求方式：post+application/json 方式
请求路径：https://open.71360.com/cgi/user/getByMobile
参数说明
| 参数 | 参数类型 | 必须 | 说明 |
|---|---|---|---|
| corpAccessToken | String | 是 | 企业应用访问公司合法性凭证 |
| corpId | String | 是 | 开放平台公司帐号 |
| mobile | String | 是 | 手机号 |
请求包结构体示例：
{
"corpAccessToken": "CORP_ACCESS_TOKEN",
"corpId": "CORP_ID",
"mobile": "155xxxx8765"
}返回说明
| 参数 | 必须 | 说明 |
|---|---|---|
| errorCode | 是 | 返回码 |
| errorMessage | 是 | 对返回码的文本描述内容 |
| errorDescription | 否 | 返回码的中文描述 |
| empList | 否 | 返回结果列表 |
| enterpriseId | 否 | 企业ei |
| openUserId | 否 | 开放平台员工账号 |
| account | 否 | 员工账号 |
| fullName | 否 | 员工姓名 |
| name | 否 | 员工昵称 |
| status | 否 | 员工状态 |
| mobile | 否 | 员工手机号 |
| leaderId | 否 | 汇报对象开平账号 |
| telephone | 否 | 电话号码 |
| role | 否 | 角色 |
| post | 否 | 职位 |
| 否 | qq | |
| email | 否 | 邮箱 |
| gender | 否 | 员工性别：M(男) F(女) |
| profileImage | 否 | 头像 |
| description | 否 | 描述 |
| weixin | 否 | 微信账号 |
| msn | 否 | msn |
| extensionNumber | 否 | extensionNumber |
| mobileSetting | 否 | 手机号隐私 |
| workingState | 否 | workingState |
| isActive | 否 | 激活状态 |
| mainDepartmentIds | 否 | 主属部门 |
| departmentIds | 否 | 所有所属部门（包括主属部门） |
| departmentAsteriskIds | 否 | 星标部门 |
| employeeAsteriskIds | 否 | 星标员工 |
| birthDate | 否 | 生日 |
| hireDate | 否 | 入职时间 |
| empNum | 否 | 员工编号 |
| startWorkDate | 否 | 就业时间 |
| stopTime | 否 | 停用时间 |
| createTime | 否 | 创建时间 |
| updateTime | 否 | 更新时间 |
| nameSpell | 否 | nameSpell |
| nameOrder | 否 | nameOrder |
a) 正确的JSON返回结果示例:
{
"empList": [
{
"enterpriseId": 590079,
"openUserId": "FSUID_69AF29A7AA695787C90614CDDE0A4968",
"account": "",
"fullName": "",
"name": "张三",
"status": "NORMAL",
"mobile": "17328366613",
"leaderId": "FSUID_6D3F8498206FD5F8B2E0559AED7737E1",
"telephone": "",
"role": "DEFAULT",
"post": "",
"qq": "",
"email": "",
"gender": "M",
"profileImage": "",
"description": "",
"weixin": "12342321111",
"msn": "",
"extensionNumber": "",
"mobileSetting": {
"mobileStatus": "PUBLIC",
"departmentIds": [],
"employeeIds": []
},
"workingState": "",
"isActive": true,
"mainDepartmentIds": [
1000
],
"departmentIds": [
1000
],
"departmentAsteriskIds": [],
"employeeAsteriskIds": [],
"birthDate": "",
"hireDate": "2018-06-27",
"empNum": "",
"startWorkDate": "",
"stopTime": 0,
"createTime": 1530083843500,
"updateTime": 1542036068500,
"nameSpell": "HUANGZHI",
"nameOrder": "H#BBC6#D6C7"
}
],
"errorCode": 0,
"errorMessage": "success",
"errorDescription": "成功"
}b) 错误的JSON返回示例:
{
"errorCode": 20017,
"errorMessage": "openCorpId not found"
}