公众号可通过该接口来获取帐号的黑名单列表,黑名单列表由一串 OpenID(加密后的微信号,每个用户对每个公众号的OpenID是唯一的)组成。
该接口每次调用最多可拉取 10000 个OpenID,当列表数较多时,可以通过多次拉取的方式来满足需求。
http请求方式: POST,http://xxx.xxx.xxx/ 为自己的网站域名 http://xxx.xxx.xxx/index.php?g=Home&m=ConnectApi&a=proxy
参数 | 是否必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
ConnectKey | 是 | 开放平台KEY |
apipath | 是 | 本接口固定为:tags.members.getblacklist |
Data | 否 | 微信请求参数,为urlencdoe之后的JSON格式 |
Data参数说明
{"begin_openid":"OPENID1"}
正确时返回 JSON数据包
{ "total":23000, "count":10000, "data":{" openid":[ "OPENID1", "OPENID2", ..., "OPENID10000" ] }, "next_openid":"OPENID10000" }
错误时返回 JSON数据包(示例为无效AppID错误)
{"errcode":40013,"errmsg":"invalid appid"}
返回码说明
返回码 | 说明 |
---|---|
-1 | 系统繁忙 |
40003 | 传入非法的openid |
49003 | 传入的openid不属于此AppID |
同时,请注意:
当公众号黑名单列表数量超过 10000 时,可通过填写 next_openid 的值,从而多次拉取列表的方式来满足需求。
具体而言,就是在调用接口时,将上一次调用得到的返回中的 next_openid 的值,作为下一次调用中的 next_openid 值。
公众号可通过该接口来拉黑一批用户,黑名单列表由一串 OpenID (加密后的微信号,每个用户对每个公众号的OpenID是唯一的)组成。
http请求方式: POST,http://xxx.xxx.xxx/ 为自己的网站域名 http://xxx.xxx.xxx/index.php?g=Home&m=ConnectApi&a=proxy
参数 | 是否必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
ConnectKey | 是 | 开放平台KEY |
apipath | 是 | 本接口固定为:tags.members.batchblacklist |
Data | 否 | 微信请求参数,为urlencdoe之后的JSON格式 |
Data参数说明
{ "opened_list":["OPENID1”,” OPENID2”] }
正确时返回 JSON数据包
{ "errcode": 0, "errmsg": "ok" }
错误时返回 JSON数据包(示例为无效AppID错误)
{"errcode":40013,"errmsg":"invalid appid"}
公众号可通过该接口来取消拉黑一批用户,黑名单列表由一串OpenID(加密后的微信号,每个用户对每个公众号的OpenID是唯一的)组成。
http请求方式: POST,http://xxx.xxx.xxx/ 为自己的网站域名 http://xxx.xxx.xxx/index.php?g=Home&m=ConnectApi&a=proxy
参数 | 是否必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
ConnectKey | 是 | 开放平台KEY |
apipath | 是 | 本接口固定为:tags.members.batchunblacklist |
Data | 否 | 微信请求参数,为urlencdoe之后的JSON格式 |
Data参数说明
{ "opened_list":["OPENID1”,” OPENID2”] }
正确时返回 JSON数据包
{ "errcode": 0, "errmsg": "ok" }
错误时返回 JSON数据包(示例为无效AppID错误)
{"errcode":40013,"errmsg":"invalid appid"}
返回码说明
返回码 | 说明 |
---|---|
-1 | 系统繁忙 |
40003 | 传入非法的openid |
49003 | 传入的openid不属于此AppID |
40032 | 一次只能拉黑20个用户 |