# 通过OpenId获取UserId

  • 商家通过调用“通过OpenId获取UserId”这个接口可以获取到UserId。

请求方式:POST

请求地址:https://$basehost/gateway/qopen/GetStaffWwUserIdByOpenId

body参数

{
  "open_id_list": ["", ""]
}
字段 类型 必填 说明
open_id_list array 企业成员open_id(获取成员列表中的account_id),最小长度1,最大长度100

返回值:

{
  "data": {
    "open_id_map": {
      "xxx": "xxx"
    },
    "failed_list": ["xxx", "xxx"]
  },
  "errcode": 0,
  "errmsg": "",
  "hint": ""
}

返回说明

字段 类型 说明
data json json返回值
failed_list array 失败编号列表
open_id_map object key为传入open_id,value为user_id
errcode int 状态码,0为正常,非0代表错误
errmsg string 错误信息
hint string 请求日志ID

完整请求示例:

curl -X POST \
  https://$basehost/gateway/qopen/GetStaffWwUserIdByOpenId \
  -H 'Content-Type: application/json; charset=UTF-8' \
  -H 'Token: c2NdxDHKXIJ5j1zrhJeq2eJEHjh9xxx' \
  -d '{"user_id_list": ["",""]}'
最后更新时间: 2026/4/3 10:52:42