此接口是在商家获取授权码后(一般在商家相关-员工登录接口后使用),根据授权码获取用户的open_id与enterprise_open_id, 商家可以在获取该用户唯一标识后,选择绑定或者信任登录该open_id绑定的用户。
部分商家是以手机号作为唯一的标准。但是针对离职再入职的用户,有可能同一手机号对应的openId是完全不一致的,导致用户因为手机号重复而无法使用该应用。 针对这种情况,商家需要提供解绑接口,供关爱通平台调用,解除旧的绑定关系,以便商家重新绑定openId。
https://openapi.guanaitong.tech/seller/person/getByAuthCode
POST
(1)公共参数
发送请求是必须传入公共参数,详见公共参数
(2)私有参数
| 参数名称 | 是否必须 | 参数类型 | 长度限制 | 描述 |
| auth_code | 是 | string | 40 | 员工授权码 |
POST /seller/person/getByAuthCode HTTP/1.1
Host: openapi.guanaitong.tech
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache
access_token=8aaca96efff711e5634b720fd9c68b99&sign=0ed7381358e8f3471e186804b1bee7e544ff9f59&
timestamp=1529046657&auth_code=1CC23B9B7BD964FA6CC37AC3CFBC806717C8B6F2
| 参数名称 | 描述 |
| code | 返回码。详见错误返回码。 |
| msg | 如果错误,返回错误信息。 |
| data | 如果没有错误,返回业务数据 |
| data.open_id | 员工唯一标识 |
| data.enterprise_open_id | 员工所属企业的唯一标识 |
{
"code": 0,
"data": {
"open_id": "555f80990ba173b95ddad6e83796e9c5",
"enterprise_open_id": "4c81084dc654c81fc1aa4b0799a4dfa9"
},
"msg": "OK"
}
{
"code": 1000210001,
"msg": "timestamp check failed!",
"data": null
}
[商家URL]/seller/person/unbind
POST
application/json;charset=utf-8
请求参数
| 参数名称 | 是否必须 | 参数类型 | 长度限制 | 描述 |
| appid | 是 | string | 8 | appid |
| openId | 是 | string | [] | openId |
| timestamp | 是 | string | [10] | 时间戳,如1469691921 |
| sign | 是 | string | [] | 签名,见开放平台通用签名 |
POST /seller/person/unbind HTTP/1.1
Host: [商家URL]
Content-Type: application/json;charset=utf-8
Cache-Control: no-cache
appid=10210123&sign=0ed7381358e8f3471e186804b1bee7e544ff9f59&
timestamp=1529046657&openId=1CC23B9B7BD964FA6CC37AC3CFBC806717C8B6F2
| 参数名称 | 描述 |
| code | 返回码 |
| msg | 如果错误,返回错误信息。 |
{
"code": 0,
"msg": "OK"
}
| 返回码 | 描述 |
| 0 | 成功 |
| 1 | 该返回码不存在 |
| 2 | 解绑失败 |