网页黑名单

更新时间：2025-03-14

1. 增加黑名单

接口描述

往黑名单中添加URL，用于检测和拦截访问，防止用户访问恶意或受限制的网站。

接口定义

URL	https://qianfan.baidubce.com/v2/ai_search/url_black_list
Method	POST
Content-Type	application/json

请求body参数

字段名	字段类型	是否必须	说明
black_item	object	是	黑名单url内容

BlackItem对象

字段名	字段类型	是否必须	说明
url	str	是	url地址，采用精确匹配策略

响应头域

除公共头域外，无其它特殊头域。

响应参数

字段	类型	必填	说明
request_id	string	是	请求request_id
code	string	否	错误代码，当发生异常时返回
message	string	否	错误消息，当发生异常时返回

请求示例

curl --location 'https://qianfan.baidubce.com/v2/ai_search/url_black_list' \
--header 'Authorization: Bearer authorization string' \
--header 'X-Appbuilder-Authorization: <token>' \
--data '{
    "black_item": {
        "url": "https://zhidao.baidu.com/question/1***79.html"
    }
}'

响应示例

{"request_id": "123"}

2. 删除黑名单

接口描述

删除黑名单中的URL。

接口定义

URL	https://qianfan.baidubce.com/v2/ai_search/url_black_list
Method	DELETE
Content-Type	application/json

请求参数

字段名	字段类型	是否必须	说明
url	str	是	待删除的url

响应参数

字段	类型	必填	说明
request_id	string	是	请求request_id
code	string	否	错误代码，当发生异常时返回
message	string	否	错误消息，当发生异常时返回

调用示例

curl -X DELETE \
-H "Authorization: Bearer authorization string" \
'https://qianfan.baidubce.com/v2/ai_search/url_black_list?url=https%3A%2F%2Fzhidao.baidu.com%2Fquestion%2F10**79.html'

响应示例

{"request_id": "123"}