查询防盗链配置

更新时间:2023-05-30 14:26:41

适用产品

应用安全解决方案、区块链安全加速解决方案、IPv6安全加速解决方案、点播分发、直播分发、移动加速、网页加速、下载分发、全站加速、应用安全加速解决方案、IPv6一体化解决方案、电商安全加速解决方案、金融安全加速解决方案、政企安全加速解决方案

接口描述

通过接口自助查询防盗链配置。接口url的*可为域名名称或域名id。

调用频率

单用户调用频率:300/5min

推荐使用 Open API在线调试

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

请求参数

Path 参数

参数名称描述
*domain-nameString
需要查询配置的域名或域名id

返回参数

Body 参数

参数名称描述
domain-nameString
需要查询配置的域名
domain-idString
需要查询配置的域名id
visit-control-rulesList
防盗链配置 注意: 1、需要取消防盗链配置设置时,可以传入空节点。 2、表示需要设置防盗链配置时,此项必填
data-idInteger
添加grid类型标识,表示客户多组配置时,具体某组配置
path-patternString
url匹配模式,支持正则,如果是全部匹配,入参可以配置为:.*
except-path-patternString
例外的url匹配模式,某些URL除外:如abc.jpg,不做防盗链功能 客户入参参考:^https?://[^/]+/.*\.m3u8
custom-patternString
指定常用类型:选择需要防盗链的域名是全部文件还是首页。入参参考值: all:全部文件 homepage:首页
file-typeString
文件类型:指定文件类型进行防盗链设置。 文件类型包括:gif png bmp jpeg jpg html htm shtml mp3 wma flv mp4 wmv zip exe rar css txt ico js swf 如果需要全部类型,则直接传all。多个以分号隔开,all和具体文件类型不能同时配置。
custom-file-typeString
自定义文件类型:在指定文件类型外根据自身需求,填写适当的可识别文件类型。可以搭配file-type使用。如果file-type也有配置,实际生效的文件类型是两个入参的总和
specify-url-patternString
指定URL缓存:根据需求指定url进行防盗链设置 入参不支持含http(s):// 开头的URI格式
directoryString
目录:指定目录进行防盗链设置 输入合法的目录格式。多个以英文分号隔开
except-file-typeString
例外的文件类型:指定不需要进行防盗链功能的文件类型 文件类型包括:gif png bmp jpeg jpg html htm shtml mp3 wma flv mp4 wmv zip exe rar css txt ico js swf 如果需要全部类型,则直接传all。多个以分号隔开,all和具体文件类型不能同时配置 如果file-type=all,except-file-type=all 则表示不匹配任务文件类型
except-custom-file-typeString
例外的自定义文件类型:在指定文件类型外根据自身需求,填写适当的可识别文件类型。可以搭配except-file-type使用。如果except-file-type也有配置,实际生效的文件类型是两个入参的总和
except-directoryString
例外的目录:指定不需要进行进行防盗链设置的目录 输入合法的目录格式。多个以英文分号隔开
control-actionString
控制方向。可选值:403和302 1) 403表示返回特定的错误状态码来拒绝服务(默认方式,状态码可以指定,一般为403)。 2) 302表示返回302 Found的重定向url,重定向的url可以指定。如果传302,rewrite-to必填
rewrite-toString
指定302跳转后的url。如果control-action值为302,此项必填
priorityInteger
表示客户多组重定向内容的优先执行顺序。数字越大,优先级越高。 新增配置项时,不传默认为 10
advance-control-rulesObject
配置其他访问控制策略,比如禁止访问的时间
invalid-timeString
禁止访问的时间
ip-control-ruleObject
标识IP黑白名单防盗链 注意: 1、表示一组黑白名单防盗链,一个data-id下只能一组 2、当传空标签表示清楚例外的IP段配置和禁止的IP段配置。
forbidden-ipsString
禁止的IP段 禁止的IP和例外的IP只能一个有值
allowed-ipsString
例外的IP段,支持输入IP或IP段,IP段之间用分号(;)隔开,如1.1.1.0/24;2.2.2.2,某些IP例外,不做防盗链
referer-control-ruleObject
标识referer防盗链 注意: 1、表示一组referer防盗链,一个data-id下只能一组 2、当传空标签表示清除referer防盗链 3、合法refer、(合法域名、合法URL)、非法refer、(非法域名、非法URL)这四项,一个data-id下只能配置一个或者都为空
allow-null-refererString
是否允许空referer:合法refer、(合法域名、合法URL)、非法refer、(非法域名、非法URL)这四项任意一项有值,则“是否允许空referer”不能为空;合法refer、(合法域名、合法URL)、非法refer、(非法域名、非法URL)这四项都为空值,则“是否允许空referer”必须为空
valid-refererString
合法referer.可以输入url或域名
valid-urlString
合法url,输入正确的url格式
valid-domainString
合法域名
invalid-refererString
非法referer,可以输入url或域名
invalid-urlString
非法url,输入正确的url格式
invalid-domainString
非法域名
ua-control-ruleObject
标识UA头防盗链, 注意: 1、表示一组UA头防盗链,一个data-id下只能一组 2、当传空标签表示清除UA头防盗链
valid-user-agentsString
允许的客户端,正则匹配,配置多个UA如:Android|iPhone
invalid-user-agentsString
禁止的客户端,正则匹配,配置多个UA如:Android|iPhone
advance-control-rulesObject
配置其他访问控制策略,比如禁止的访客区域,JSON示例: advance-control-rules:{invalid-visitor-region:CN;JP;KR}
invalid-visitor-regionString
禁止的访客区域,多个请用英文分号分隔。注意 1、仅支持iso 3166-1国家二字简称 2、如果有特殊区域配置需求,请联系您的专属。 3、同一组规则里,禁止的访客区域、允许的访客区域,不能同时配
valid-visitor-regionString
允许的访客区域,多个请用英文分号分隔。注意 1、仅支持iso 3166-1国家二字简称 2、如果有特殊区域配置需求,请联系您的专属。 3、同一组规则里,禁止的访客区域、允许的访客区域,不能同时配

示例

JSON
XML
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/config/visitcontrol/a1.example.com" \
-X "GET" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/json" \
-H "Content-Type:application/json" \
返回示例
复制代码 复制成功
HTTP/1.1 200 OK
Date: Sun, 05 May 2019 09:08:53 GMT
Content-Type: application/json;charset=utf-8
x-cnc-request-id: 83bbebc7-2c95-47d7
{
    "domain-id":"123344",
    "domain-name":"www.example.com",
    "visit-control-rules": [{
        "ip-control-rule": {
            "forbidden-ips": "1.2.3.4"
        },
        "priority": 9,
        "control-action": "403",
        "rewrite-to": "",
        "except-directory": "",
        "directory": "/home/",
        "specify-url-pattern": "",
        "custom-file-type": "",
        "path-pattern": "",
        "referer-control-rule": {
            "allow-null-referer": "true",
            "valid-domain": "c.com;d.com",
            "valid-url": "http://b.com"
        }
        "ua-control-rule":{
            "valid-user-agents":"Android|iPhone",
            "invalid-user-agents":""
        }
    }]
}
本篇文档内容对您是否有帮助?
有帮助
我要反馈
提交成功!非常感谢您的反馈,我们会继续努力做到更好!