获取Bot概览的统计数据
更新时间：2023-02-03 10:30:29
适用产品
BotGuard爬虫管理
接口描述
统计指定域名的请求攻击数据，包括：总请求数、已知Bot类型攻击数、未知Bot类型攻击数、缓解bot攻击数
- 调用URL： https://open.chinanetcenter.com/api/bot/report/request-visit
- 调用方法：POST
推荐使用 Open API在线调试
Open API在线调试功能提供可视化界面在线调试API、支持生成代码示例、快速检索查看API文档等能力。前往调试
请求参数
Body 参数
| 参数名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
domain | String | 是 | 域名。多个以;隔开 |
startTime | String | 是 | 开始时间。格式： yyyy-MM-dd HH:mm:ss |
endTime | String | 是 | 结束时间。格式： yyyy-MM-dd HH:mm:ss |
timeZone | Integer | 否 | 时区，默认8，即“GTM+8” |
返回参数
Body 参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
code | String | 状态码，成功为“200”。 |
message | String | 返回信息，成功为“Success”。 |
data | GetBotRequestOverviewDataResponseData | 返回数据。 |
goodBotRequest | Long | 已知Bot类型请求数。 |
reliefRequest | Long | 缓解Bot攻击数。 |
totalRequest | Long | 总请求数。 |
unknowBotRequest | Long | 未知Bot类型请求数。 |
错误码
| 错误代码（code） | 描述（message） | HTTP状态码 | 语义 |
|---|---|---|---|
| 22994001 | CUSTOMER_NOT_EXIST | 200 | 客户不存在 |
| 22994000 | PARAM_ERROR_CODE | 200 | 查询参数错误 |
| 22995000 | INTERNAL_ERROR_CODE | 200 | 系统错误 |
示例
JSON
- 请求示例 复制成功
#!/bin/bash username="example_username" apiKey="example_apiKey" date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"` password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64` curl -i --url https://open.chinanetcenter.com/api/bot/report/request-visit \ -X "POST" \ -u "$username:$password" \ -H "Date: $date" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{ "domain":"example1.xxx.xxx;example2.xxx.xxx;example3.xxx.xxx;", "startTime":"2021-12-03 00:00:00", "endTime":"2021-12-03 23:59:59" }'- 返回示例 复制成功
{ "code": 200, "message": "SUCCESS", "data": { "goodBotRequest": 4, "reliefRequest": 253, "totalRequest": 623, "unknowBotRequest": 283 } }
本篇文档内容对您是否有帮助？
有帮助
我要反馈