网页黑名单
更新时间：2025-04-14
1. 增加黑名单
接口描述
往黑名单中添加URL，用于检测和拦截访问，防止用户访问恶意或受限制的网站。
权限说明
Authorization需要填写密钥。
注意事项
- 按照用户id（鉴权token对应的用户id）来区分过滤规则，某个用户id配置的规则，仅对该用户生效
- 调用网页黑名单接口的用户id要和调用问答接口的用户id保持一致
- 网页过滤发生在百度搜索之后，过滤掉的网页，不参与模型问答总结
接口定义
| 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需要填写密钥。
注意事项
- 按照用户id（鉴权token对应的用户id）来区分过滤规则，某个用户id配置的规则，仅对该用户生效
- 调用网页黑名单接口的用户id要和调用问答接口的用户id保持一致
- 网页过滤发生在百度搜索之后，过滤掉的网页，不参与模型问答总结
接口定义
| 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"}