资讯 文档
技术能力
语音技术
文字识别
人脸与人体
图像技术
语言与知识
视频技术

网页黑名单

1. 增加黑名单

接口描述

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

权限说明

Authorization需要填写密钥。

注意事项

  1. 按照用户id(鉴权token对应的用户id)来区分过滤规则,某个用户id配置的规则,仅对该用户生效
  2. 调用网页黑名单接口的用户id要和调用问答接口的用户id保持一致
  3. 网页过滤发生在百度搜索之后,过滤掉的网页,不参与模型问答总结

接口定义

URL https://qianfan.baidubce.com/v2/ai_search/url_black_list
Method POST
Content-Type application/json
Authorization 请求签名(Bearer )

请求结构

POST /v2/ai_search/url_black_list HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <AppBuilder API Key>
Content-Type: application/json
{
    "black_item": {
        "url": "https://z***o.baidu.com/question/150***8519979.html"
    }
}

请求body参数

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

BlackItem对象

字段名 字段类型 是否必须 说明
url str 按照url进行前缀匹配过滤,对应以下两种情况:
1. 如果url设置为,https://unsafe.com/ ,则该站点下的所有网页均会被过滤
2. 如果url设置为,https://zhidao.baidu.com/question/1.html, 则仅会过滤https://zhidao.baidu.com/question/1.html网页

响应头域

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

响应参数

字段 类型 必填 说明
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。

权限说明

Authorization需要填写密钥。

注意事项

  1. 按照用户id(鉴权token对应的用户id)来区分过滤规则,某个用户id配置的规则,仅对该用户生效
  2. 调用网页黑名单接口的用户id要和调用问答接口的用户id保持一致
  3. 网页过滤发生在百度搜索之后,过滤掉的网页,不参与模型问答总结

接口定义

URL https://qianfan.baidubce.com/v2/ai_search/url_black_list
Method DELETE
Content-Type application/json
Authorization 请求签名(Bearer )

请求参数

字段名 字段类型 是否必须 说明
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"}
上一篇
知识干预
下一篇
错误码