# 获取长期订阅用户

接口应在服务器端调用,详细说明参见服务端API

本接口支持云调用。需开发者工具版本 >= 1.02.1904090(最新稳定版下载),wx-server-sdk >= 0.4.0

# 接口说明

# 接口英文名

getFollowers

# 功能描述

该接口用于获取长期订阅用户列表。

# 调用方式

# HTTPS 调用


POST https://api.weixin.qq.com/wxa/business/get_wxa_followers?access_token=ACCESS_TOKEN 

# 云调用

  • 出入参和HTTPS调用相同,调用方式可查看云调用说明文档

  • 接口方法为: openapi.liveBroadcast.getFollowers

# 第三方调用

  • 调用方式以及出入参和HTTPS相同,仅是调用的token不同

  • 该接口所属的权限集id为:52

  • 服务商获得其中之一权限集授权后,可通过使用authorizer_access_token代商家进行调用

# 请求参数含义

参数 类型 必填 说明
limit Number 获取长期订阅用户的个数限制,默认200,最大2000
page_break Number 翻页标记,获取第一页时不带,第二页开始需带上上一页返回结果中的page_break

# 返回参数含义

参数 说明
followers 长期订阅用户列表
openid 长期订阅用户OpenId
subscribe_time 长期订阅用户订阅时间
room_id 用户订阅时所处房间
room_status 用户订阅时房间状态
page_break 翻页标记,获取下一页时带上该值
errcode 接口返回码,0表示成功,非0则失败
errmsg 接口返回提示信息

# 调用示例

示例说明: HTTPS请求示例

# 请求数据示例


{    
    "limit": 200,
    "page_break":0 
} 

# 返回数据示例


{
    "errcode": 0,
    "errmsg": "ok"
} 

# 错误码

错误码 错误码取值 解决方案
40001 invalid credential  access_token isinvalid or not latest 获取 access_token 时 AppSecret 错误,或者 access_token 无效。请开发者认真比对 AppSecret 的正确性,或查看是否正在为恰当的公众号调用接口