文档中心 商家相关 员工标识

员工标识

1.使用场景

此接口是在商家获取授权码后(一般在商家相关-员工登录接口后使用),根据授权码获取用户的open_id与enterprise_open_id, 商家可以在获取该用户唯一标识后,选择绑定或者信任登录该open_id绑定的用户。


部分商家是以手机号作为唯一的标准。但是针对离职再入职的用户,有可能同一手机号对应的openId是完全不一致的,导致用户因为手机号重复而无法使用该应用。 针对这种情况,商家需要提供解绑接口,供关爱通平台调用,解除旧的绑定关系,以便商家重新绑定openId。

2.接口调用说明

请求URL

https://openapi.guanaitong.tech/seller/person/getByAuthCode

HTTP请求方式

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
}

3.解绑接口

请求URL

[商家URL]/seller/person/unbind

HTTP请求方式

POST

Content-Type

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 解绑失败