网页黑名单
更新时间：2025-10-29
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 | 否 | 错误消息，当发生异常时返回 |
请求示例
Plain Text
1curl --location 'https://qianfan.baidubce.com/v2/ai_search/url_black_list' \
2--header 'Authorization: Bearer authorization string' \
3--header 'X-Appbuilder-Authorization: <token>' \
4--data '{
5 "black_item": {
6 "url": "https://zhidao.baidu.com/question/1***79.html"
7 }
8}'响应示例
Plain Text
1{"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 | 否 | 错误消息，当发生异常时返回 |
调用示例
Plain Text
1curl -X DELETE \
2-H "Authorization: Bearer authorization string" \
3'https://qianfan.baidubce.com/v2/ai_search/url_black_list?url=https%3A%2F%2Fzhidao.baidu.com%2Fquestion%2F10**79.html'响应示例
Plain Text
1{"request_id": "123"}