文档中心 信任登录 同步员工信息并获取授权码(特殊)

同步员工信息并获取授权码(特殊)

1.功能说明

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

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


注意事项:

(1)集团对接,在关爱通开通集团与多家所属企业;

(2)员工关系仅靠此接口维护,不会通过别的途径添加;

(3)enterprise_code与关爱通企业关系需要事先找gat技术绑定;

(4)员工调转是异步的操作,会有延时;

2.接口调用说明

请求URL

https://openapi.guanaitong.tech/sso/employee/syncUserAndGetAuthCode

HTTP请求方式

POST

输入参数说明

(1)公共参数

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

(2)私有参数

参数名称 是否必须 参数类型 长度限制 描述
corp_code string [1,20] 第三方员工唯一标识(不区分大小写,小写会统一转为大写)
enterprise_code string [1,20] 第三方企业标识(使用前需要通知gat技术,绑定gat内对应企业)
mobile_area int [1,10] 手机号区号,默认86
mobile string [6,20] 员工手机号(第三方唯一)
name string [1,50] 员工姓名(不填,则默认name值为corp_code)
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&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
}