跳转至

员工openid绑定和查询

功能说明

根据userid生成关爱通员工openid，对应商家侧buyer_open_id，如果存在则直接返回

接口地址

HTTP请求方式

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

参数说明

  • 公有参数

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

  • 私有参数

参数名称 是否必须 参数类型 长度限制 描述
userid 是 string [1,100] 员工第三方唯一标识，不会变更
enterprise_code 否 string [1,20] 企业编号（集团和运营商必填,单企业不填）
seller_appid 是 string [8] 商家appid，用于商家侧调用该员工相关包含buyer_open_id字段的接口
third_type 否 int [1-5] 1:企业微信, 2:钉钉,3:飞书,4, 定制, 5:标准对接,非必填默认5

请求示例（HTTP）

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

access_token=a9574640d1030306d684706ecbf5d84f&userid=LOL001&seller_appid=20193829&
timestamp=1492671874&sign=b314c43d96345a364c65c982ef1c95ab55fa3482

返回参数说明

参数名称 描述
code 返回码。详见错误返回码。
msg 如果错误，返回错误信息。
data 如果没有错误，返回业务数据
data.userid 企业员工同步时传递的唯一标识
data.open_userid 关爱通对外的用户open_id
data.seller_appid 第三方应用appid

正确返回示例

{
    "code":0,
    "data":{
        "userid": "r32523r32eqw",
        "open_userid": "kof08f25d0ae36225281f7378e1fc934",
        "seller_appid":"20132407"
    },
    "msg":"OK"
}

错误返回示例

{
    "code": 1000210004,
    "data": null,
    "msg": "tokeninfo check failed!"
}

常见错误码

错误码 错误信息 排查方法
1000220002 userid、mobile和email最少填一项 检测参数是否按要求填写
1000220096 该用户ID对应员工不存在 userid对应员工是否已添加
1000220102 员工不存在 userid对应员工是否已添加
1000240002 enterprise_code校验失败 检查enterprise_code是否是已绑定的编码
other 其他公共错误码 其他公共错误码
回到页面顶部