应用安全解决方案、区块链安全加速解决方案、IPv6安全加速解决方案、点播分发、直播分发、移动加速、网页加速、下载分发、全站加速、应用安全加速解决方案、IPv6一体化解决方案、电商安全加速解决方案、金融安全加速解决方案、政企安全加速解决方案
通过接口自助查询防盗链配置。接口url的*可为域名名称或域名id。
单用户调用频率:300/5min
Open API在线调试功能提供可视化界面在线调试API、支持生成代码示例、快速检索查看API文档等能力。前往调试
参数名称 | 类型 | 必填 | 描述 |
---|---|---|---|
domain-name | String | 是 | 需要查询配置的域名或域名id |
参数名称 | 类型 | 描述 |
---|---|---|
domain-name | String | 需要查询配置的域名 |
domain-id | String | 需要查询配置的域名id |
visit-control-rules | List | 防盗链配置
注意:
1、需要取消防盗链配置设置时,可以传入空节点 |
data-id | Integer | 添加grid类型标识,表示客户多组配置时,具体某组配置 |
path-pattern | String | url匹配模式,支持正则,如果是全部匹配,入参可以配置为:.* |
except-path-pattern | String | 例外的url匹配模式,某些URL除外:如abc.jpg,不做防盗链功能 客户入参参考:^https?://[^/]+/.*\.m3u8 |
custom-pattern | String | 指定常用类型:选择需要防盗链的域名是全部文件还是首页。入参参考值: all:全部文件 homepage:首页 |
file-type | String | 文件类型:指定文件类型进行防盗链设置。 文件类型包括: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-type | String | 自定义文件类型:在指定文件类型外根据自身需求,填写适当的可识别文件类型。可以搭配file-type使用。如果file-type也有配置,实际生效的文件类型是两个入参的总和 |
specify-url-pattern | String | 指定URL缓存:根据需求指定url进行防盗链设置 入参不支持含http(s):// 开头的URI格式 |
directory | String | 目录:指定目录进行防盗链设置 输入合法的目录格式。多个以英文分号隔开 |
except-file-type | String | 例外的文件类型:指定不需要进行防盗链功能的文件类型 文件类型包括: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-type | String | 例外的自定义文件类型:在指定文件类型外根据自身需求,填写适当的可识别文件类型。可以搭配except-file-type使用。如果except-file-type也有配置,实际生效的文件类型是两个入参的总和 |
except-directory | String | 例外的目录:指定不需要进行进行防盗链设置的目录 输入合法的目录格式。多个以英文分号隔开 |
control-action | String | 控制方向。可选值:403和302 1) 403表示返回特定的错误状态码来拒绝服务(默认方式,状态码可以指定,一般为403)。 2) 302表示返回302 Found的重定向url,重定向的url可以指定。如果传302,rewrite-to必填 |
rewrite-to | String | 指定302跳转后的url。如果control-action值为302,此项必填 |
priority | Integer | 表示客户多组重定向内容的优先执行顺序。数字越大,优先级越高。 新增配置项时,不传默认为 10 |
advance-control-rules | Object | 配置其他访问控制策略,比如禁止访问的时间 |
invalid-time | String | 禁止访问的时间 |
ip-control-rule | Object | 标识IP黑白名单防盗链 注意: 1、表示一组黑白名单防盗链,一个data-id下只能一组 2、当传空标签表示清楚例外的IP段配置和禁止的IP段配置。 |
forbidden-ips | String | 禁止的IP段 禁止的IP和例外的IP只能一个有值 |
allowed-ips | String | 例外的IP段,支持输入IP或IP段,IP段之间用分号(;)隔开,如1.1.1.0/24;2.2.2.2,某些IP例外,不做防盗链 |
referer-control-rule | Object | 标识referer防盗链 注意: 1、表示一组referer防盗链,一个data-id下只能一组 2、当传空标签表示清除referer防盗链 3、合法refer、(合法域名、合法URL)、非法refer、(非法域名、非法URL)这四项,一个data-id下只能配置一个或者都为空 |
allow-null-referer | String | 是否允许空referer:合法refer、(合法域名、合法URL)、非法refer、(非法域名、非法URL)这四项任意一项有值,则“是否允许空referer”不能为空;合法refer、(合法域名、合法URL)、非法refer、(非法域名、非法URL)这四项都为空值,则“是否允许空referer”必须为空 |
valid-referer | String | 合法referer.可以输入url或域名 |
valid-url | String | 合法url,输入正确的url格式 |
valid-domain | String | 合法域名 |
invalid-referer | String | 非法referer,可以输入url或域名 |
invalid-url | String | 非法url,输入正确的url格式 |
invalid-domain | String | 非法域名 |
ua-control-rule | Object | 标识UA头防盗链, 注意: 1、表示一组UA头防盗链,一个data-id下只能一组 2、当传空标签表示清除UA头防盗链 |
valid-user-agents | String | 允许的客户端,正则匹配,配置多个UA如: |
invalid-user-agents | String | 禁止的客户端,正则匹配,配置多个UA如: |
advance-control-rules | Object | 配置其他访问控制策略,比如禁止的访客区域,JSON示例: advance-control-rules:{invalid-visitor-region:CN;JP;KR} |
invalid-visitor-region | String | 禁止的访客区域,多个请用英文分号分隔。注意 1、仅支持iso 3166-1国家二字简称 2、如果有特殊区域配置需求,请联系您的专属。 3、同一组规则里,禁止的访客区域、允许的访客区域,不能同时配 |
valid-visitor-region | String | 允许的访客区域,多个请用英文分号分隔。注意 1、仅支持iso 3166-1国家二字简称 2、如果有特殊区域配置需求,请联系您的专属。 3、同一组规则里,禁止的访客区域、允许的访客区域,不能同时配 |
#!/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":"" } }] }