# 获取屏蔽的广告主

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

# 接口说明

# 接口英文名

GetBlackList

# 功能描述

该 API 用于查询当前小程序广告屏蔽的广告主。使用过程中如遇到问题，可在开放平台服务商专区交流专区 | 微信开放社区发帖交流。

# 注意事项

其中access_token为authorizer_access_token

# 调用方式

# HTTPS 调用


POST https://api.weixin.qq.com/wxa/operationams?action=agency_get_black_list&access_token=xxxxxxxxxxxxxxx

# 请求参数

属性	类型	必填	说明

# 返回参数

属性

类型

说明

ret

number

错误码

err_msg

string

返回错误信息

blacklist_biz

array<object>

blacklist_biz

属性

类型

说明

item

array<object>

item

属性	类型	说明
id	string	屏蔽公众号微信号
name	string	屏蔽公众号名称
url	string	屏蔽公众号头像URL

blacklist_weapp

array<object>

blacklist_weapp

属性

类型

说明

item

array<object>

item

属性	类型	说明
id	string	屏蔽小程序/小游戏原始ID
name	string	屏蔽小程序/小游戏名称
url	string	屏蔽小程序/小游戏头像URL

blacklist_ios

array<object>

blacklist_ios

属性

类型

说明

item

array<object>

item

属性	类型	说明
id	string	屏蔽IOS应用的APPID
name	string	屏蔽IOS应用名称
url	string	屏蔽IOS应用标识图片

blacklist_android

array<object>

blacklist_android

属性

类型

说明

item

array<object>

item

属性	类型	说明
id	string	屏蔽安卓应用的应用宝包名
name	string	屏蔽安卓应用的名称
url	string	屏蔽安卓应用标识图片

# 调用示例

示例说明: HTTPS请求

# 请求数据示例

{}

# 返回数据示例


{
    "ret": 0, // 仅在接口调用失败返回
    "err_msg": "", // 仅在接口调用失败返回
    "blacklist_biz": [
        {
            "id": "id1",
            "name": "name1",
            "icon": "png_url1"
        },
        {
            "id": "id2",
            "name": "name2",
            "icon": "png_url2"
        }
    ],
    "blacklist_weapp": [
        {
            "id": "id3",
            "name": "name3",
            "icon": "png_url3"
        }
    ],
    "blacklist_ios": [
        {
            "id": "id4",
            "name": "name4",
            "icon": "png_url4"
        }
    ],
    "blacklist_android": [
        {
            "id": "id5",
            "name": "name5",
            "icon": "png_url5"
        }
    ]
}

# 错误码

错误码	错误码取值	解决方案
0	ok	ok
-202	内部错误	可在一段时间后重试
1700	参数错误	检验输入参数是否符合文档说明
1701	参数错误	检验输入参数是否符合文档说明
1735	商户未完成协议签署流程	完成签约操作
1737	操作过快	等待一分钟后重新操作
1807	无效流量主	通过开通流量主接口为该appid开通流量主
2009	无效流量主	通过开通流量主接口为该appid开通流量主
2056	服务商未在变现专区开通账户	在第三方平台页面的变现专区开通服务