跳转至

同步员工信息并获取授权码

功能说明

此接口适用于集团和企业对接，无需在关爱通平台先添加员工的场景。

依赖此接口提供的参数，开放平台内部实现企业与关爱通平台员工的同步，同步包括员工的添加，信息修改与员工所属企业的变动

注意事项：

（1）集团对接，在关爱通开通集团与多家所属企业；

（2）员工关系仅靠此接口维护，不会通过别的途径添加；

（3）enterprise_code与关爱通企业关系需要事先找gat技术绑定；

（4）员工调转是异步的操作,会有延时；

接口地址

HTTP请求方式

  • Method: POST
  • Content-Type: application/x-www-form-urlencoded

参数说明

  • 公有参数

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

  • 私有参数

参数名称 是否必须 参数类型 长度限制 描述
userid 是 string [1,100] 第三方员工唯一标识
name 是 string [1,50] 员工姓名
code 否 string [1,20] 员工工号，如果为空，使用userid转换为大写的值作为工号
enterprise_code 否 string [1,20] 第三方企业标识（使用前需要通知gat技术，绑定gat内对应企业）
mobile_area 否 int [1,10] 手机号区号，默认86
mobile 否 string [6,20] 员工手机号（第三方唯一）
gender 否 int [1] 性别:1.男,2.女

请求示例

POST /sso/employee/syncUserAndGetAuthCode HTTP/1.1
Host: openapi.guanaitong.tech
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache

access_token=efab39effde9a19f08ba9717cd22a6f9&mobile_area=86&name=alask&mobile=13911122211&gender=1&corp_code=122212112&
timestamp=1499932763&enterprise_code=test01&sign=5306a8d71d13c126f1ad08e480df63d5e3f7e54d

返回参数说明

参数名称 描述
code 返回码。详见错误代码。
msg 如果错误，返回错误信息。
data 如果没有错误，返回业务数据-授权码

正确返回示例

{
  "code" : 0,
  "msg" : "OK",
  "data" : "26308B644B9743C62F473176A17D26A5A1BDF07A"
}

错误返回示例

{
    "code": 1000210004,
    "msg": "tokeninfo check failed!",
    "data": null
}
回到页面顶部