# 接口说明

  • 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

返回结果


{
    "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
lastUpdate: 2/9/2022, 9:55:31 AM