在线客服

全球共有40多个国家和地区5000多个平台,200万+商户使用

我要试用
文档中心 > 开放平台

黑名单管理

更新时间:2017/11/16

1. 获取公众号的黑名单列表

公众号可通过该接口来获取帐号的黑名单列表,黑名单列表由一串 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 值。

2. 拉黑用户

公众号可通过该接口来拉黑一批用户,黑名单列表由一串 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"}

2. 取消拉黑用户

公众号可通过该接口来取消拉黑一批用户,黑名单列表由一串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个用户

合肥彼岸互联信息技术有限公司  合肥市高新区亚夏汽车大厦17楼
工信部备案号: 皖B2-20150071-4  增值电信业务经营许可证:皖B2-20150071-4 安全联盟认证
友情链接: o2o生活通系统 微分销系统 兄弟连教育 火车采集器 加速乐 站长团购 后盾IT教育 php A5创业网 微信H5游戏营销