文档中心 API文档 查询指纹分析

查询指纹分析

更新时间:2023-02-03 10:23:21

适用产品

BotGuard爬虫管理

接口描述

推荐使用 Open API在线调试

Open API在线调试功能提供可视化界面在线调试API、支持生成代码示例、快速检索查看API文档等能力。前往调试

请求参数

Body 参数

参数名称描述
*domainString
域名。

返回参数

Body 参数

参数名称描述
codeString
状态码,成功为“200”。
messageString
返回信息,成功为“Success”。
dataData
返回数据。
edgebot_user_fingerprint_challengeFingerprint
用户指纹分析。
enableInteger
指纹开关。 0:关闭 1:启用
analysis_frequencyInteger
分析频率。单位:分
statistical_periodInteger
触发条件-统计周期。单位:分
ip_thresholdInteger
IP个数。
action_typeInteger
处理动作。 1:拦截 2:监控 5:断开连接
action_timeInteger
处理动作持续时间。单位:分
fp_rowsList
防护路径内容。
protection_scopeInteger
防护范围。 0:全站 3:完整URI 4:正则匹配
protection_methodInteger
防护的请求方法 。 0:All 1:GET 2:POST 3:GET/POST
protection_contentString
防护路径内容。
edgebot_device_fingerprint_challengeFingerprint
浏览器指纹分析。
enableInteger
指纹开关。 0:关闭 1:启用
analysis_frequencyInteger
分析频率。单位:分
statistical_periodInteger
触发条件-统计周期。单位:分
ip_thresholdInteger
IP个数。
action_typeInteger
处理动作。 1:拦截 2:监控 5:断开连接
action_timeInteger
处理动作持续时间。单位:分
fp_rowsList
防护路径内容。
protection_scopeInteger
防护范围。 0:全站 3:完整URI 4:正则匹配
protection_methodInteger
防护的请求方法 。 0:All 1:GET 2:POST 3:GET/POST
protection_contentString
防护路径内容。

错误码

错误代码(code)描述(message)HTTP状态码语义
22994001CUSTOMER_NOT_EXIST200客户不存在
22994000PARAM_ERROR_CODE200参数错误
22995000INTERNAL_ERROR_CODE200系统错误

示例

JSON
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/domainConfig/get-fingerprint-challenge \
-X "POST"  \
-u "$username:$password"  \
-H "Date: $date"   \
-H "Accept: application/json"  \
-H "Content-Type: application/json" \
-d '{
       "domain": "test.com"
}'
返回示例
复制代码 复制成功
{
    "message": "Success",
    "code": "200",
    "data": {
        "edgebot_user_fingerprint_challenge": {
            "action_time": "15",
            "fp_rows": [
                {
                    "protection_scope": "0",
                    "protection_content": ".*",
                    "protection_method": "3"
                }
            ],
            "action_type": "1",
            "enable": "1",
            "statistical_period": "12",
            "ip_threshold": "13",
            "analysis_frequency": "333"
        },
        "edgebot_device_fingerprint_challenge": {
            "action_time": "120",
            "fp_rows": [
                {
                    "protection_scope": "3",
                    "protection_content": "/a",
                    "protection_method": "0"
                }
            ],
            "action_type": "2",
            "enable": "1",
            "statistical_period": "5",
            "ip_threshold": "3",
            "analysis_frequency": "20"
        }
    }
}
本篇文档内容对您是否有帮助?
有帮助
我要反馈
提交成功!非常感谢您的反馈,我们会继续努力做到更好!