# 获取机构绑定的推客信息

接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南

接口英文名:getbindsharerlist

可通过该接口,可获取当前机构绑定的推客信息

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/channels/ec/promoter/get_bind_sharer_list?access_token=ACCESS_TOKEN

# 云调用

  • 本接口不支持云调用

# 第三方调用

  • 本接口不支持第三方平台调用。

# 2. 请求参数

# 查询参数 Query String parameters

参数名类型必填示例说明
access_tokenstringACCESS_TOKEN接口调用凭证,可使用 access_token

# 请求体 Request Payload

参数名类型必填示例说明
next_keystring分页参数,第一页为空,后面返回前面一页返回的数据
page_sizenumber10一页获取多少个推客,最大 20
sharer_appidstring查询某个推客,传入推客的appid
sharer_openidstring查询某个推客,传入推客的小程序openid。 必须是机构绑定小程序的用户openid,而不能是其他小程序的用户openid。

# 3. 返回参数

# 返回体 Response Payload

参数名类型示例说明
errcodenumber0错误码
errmsgstringok错误信息
sharer_info_listobjarray推客的绑定参数列表
next_keystring和机构的绑定状态,0:未绑定 1:已绑定

# Res.sharer_info_list(Array) Object Payload

推客的绑定参数列表

参数名类型说明
sharer_appidstring推客的 appid
bind_timenumber绑定时间戳
commission_rationumber分佣比例
commission_typenumber分佣类型【0:平台分佣 1:机构分佣】
nicknamestring推客的昵称
head_img_urlstring推客的头像

# 4. 注意事项

本接口无特殊注意事项

# 5. 代码示例

请求示例

{
    "next_key": "",
    "page_size": 10,
    "sharer_appid":"",
    "sharer_openid":""
}

返回示例

{
  "errcode": "0",
  "errmsg": "ok",
  "sharer_info_list": [
    {
      "sharer_appid": "推客的 appid 内容",
      "bind_time": 1624082155,
      "commission_ratio":10000,
      "commission_type": 1,
      "nickname": "",
      "head_img_url": ""
    }
  ],
  "next_key":""
}

# 6. 错误码

以下是本接口的错误码列表,其他错误码可参考 通用错误码

错误码错误描述解决方案
10024000参数错误检查必须填写的参数和参数值的范围
10071056请求参数(如sharer_openid)对应的小程序未绑定到当前机构修改为机构绑定的小程序对应的用户openid

# 7. 适用范围

本接口暂未明确可调用账号类型,或在业务中根据调用传参自行确定是否可调用,请已实际调用情况为准。