# 接口说明
- 1.最新接口
- 2.支持批量绑定
- 3.如果员工信息已经在组织架构中(通过管理后台导入),但是没有绑定第三方用户ID,则进行该接口的调用.若通过接口同步组织架构和人员信息,则不需要调用此接口
| 请求方式 | 请求地址 |
|---|---|
| POST | /openapi/func/employee/bind |
请求参数
| 字段 | 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| timestamp | 时间戳 | long | Y | 13位时间戳 |
| sign | 签名 | string | Y | 9joljoifj |
| access_token | token | string | Y | 登录 token |
| employee_id | 操作人id | string | Y | 操作人id,调用接口人 id |
| employee_type | 用户类型 | string | Y | 类型,0为分贝用户,1为第三方用户 |
| data | 请求数据 | jsonstring | Y | 请求数据 |
| data.bind_employee_list | 员工信息 | jsonarray | Y | 员工信息 |
| data.bind_employee_list.phone | 手机号 | string | Y | |
| data.bind_employee_list.third_employee_id | 第三方用户id | string | Y | 第三方人员ID |
响应参数
| 字段 | 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| request_id | 请求id | string | Y | 请求id |
| code | 响应码 | integer | Y | 0:成功; |
| msg | 响应信息 | string | N | success |
| data | 响应数据 | jsonObject | N | |
| data.successList | 员工绑定成功信息 | jsonArray | N | 员工绑定成功信息 |
| data.successList.phone | 手机号 | string | N | 手机号 |
| data.successList.thirdEmployeeId | 第三方用户id | string | N | 第三方用户id |
| data.successList.employeeId | 员工id | string | N | 员工id |
| data.result | 员工绑定失败信息 | jsonArray | N | 员工绑定失败信息 |
| data.result.reason | 失败原因 | string | N | 失败原因 |
| data.result.code | 错误码 | integer | N | 错误码 |
| data.result.thirdEmployeeId | 第三方用户id | string | N | 第三方用户id |
请求示例:
"access_token": "xxx.xxx.xxx",
"timestamp": 1596697247000,
"employee_id":"third_jianyuan",
"employee_type":"1",
"sign": "jifejful83kd93mf8",
"data":
{
"bind_employee_list":
[
{
"phone":"13131313131",
"third_employee_id":"test_60000"
}
]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
返回结果
{
"request_id": "5XGKPzb2XESpQ85ix4Df",
"code": 0,
"msg": "success",
"data": {
"result": [
{
"reason": "手机号不存在或者不在该公司下",
"code": 100001,
"thirdEmployeeId": "third_test_bind002"
},
{
"reason": "第三方ID已经被其它用户绑定",
"code": 100006,
"thirdEmployeeId": "third_test_bind001"
}
],
"successList": [
{
"employeeId": "63474817482379",
"phone": 13609876544,
"thirdEmployeeId": "third_test_bind002"
},
{
"employeeId": "3645837598798",
"phoone": 139098766546,
"thirdEmployeeId": "third_test_bind002"
}
]
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34