设置域名配置（内部详细版文档） 下载PDF文档

接口地址

请求URL: domain/config (POST)

接口请求域名: cdn.api.baishan.com
接口版本: v2

接口描述

对加速域名各项配置进行设置和修改，例如：缓存规则，IP黑名单，referer防盗链，源站，回源host等。

注意： 接口调用频率不超过30次/分钟。

各项配置(referer、origin、cache_rule)可以一并提交，也可以单独提交，当多个配置一起提交时，如果存在某一项配置规则不合法，那么单次提交的所有配置均无法保存。

输入参数

公有参数：用户的 token 可向值班同事获取。

请求参数(POST)

参数支持 form-data、x-www-form-urlencoded、json 等格式

origin (回源配置)

#回源配置
curl -X POST "https://cdn.api.baishan.com/v2/domain/config"\
  -H 'content-type: application/json' \
  -d '{
    "token":"xxx",
    "domains":"example.com",
    "config": {   
        "origin": {
            "default_master":"1.1.1.1,1.1.1.2",
            "default_slave":"2.2.2.2",
            "origin_mode":"custom",
            "ori_https":"yes",
            "port":1040
        }
    }
}'

origin_host (回源HOST)

# 设置源站host
curl -X POST "https://cdn.api.baishan.com/v2/domain/config"\
  -H 'content-type: application/json' \
  -d '{
    "token":"xxx",
    "domains":"example.com",
    "config": {   
        "origin_host": {
            "host": "www.example.com"
        }
    }
}'

referer (referer黑白名单)

# 设置referer黑名单
curl -X POST "https://cdn.api.baishan.com/v2/domain/config"\
  -H 'content-type: application/json' \
  -d '{
    "token":"xxx",
    "domains":"example.com",
    "config": {   
        "referer": {
            "type":"1",
            "list":[
                "*.example.com",
                "www.example2.com"
            ],
            "allow_empty":true
        }
    }
}'

# 设置referer白名单
curl -X POST "https://cdn.api.baishan.com/v2/domain/config"\
  -H 'content-type: application/json' \
  -d '{
    "token":"xxx",
    "domains":"example.com",
    "config": {   
        "referer": {
            "type":"2",
            "list":[
                "*.example.com",
                "www.example2.com"
            ],
            "allow_empty":false
        }
    }
}'

cache_rule (缓存规则)

缓存优先级说明 : 优先级按规则数组排序，由高至低排序
缓存规则正则使用说明 : 正则规则是作为一般类型无法满足情形下的补充, 使用不当会引起缓存不必要的故障, 建议有一定正则基础的开发者使用, 请理解清楚正则的使用规则后再应用到线上服务中, 设置缓存规则为正则, 会将请求的url地址(url地址:包含http/https协议部分、域名、端口[有的话]、路径、参数等几个部分)与正则去做匹配, 匹配成功则会使用该规则设定的缓存时间.

1. 举例1: .*\.(gif|png|jpg)$, 那么他将匹配所有含(gif,png,jpg)文件名后缀的url
2. 举例2: ^https?://[^/]+/dir1/dir2/(dir3_1|dir3_2)\.html, 该规则匹配当前域名下/dir1/dir2/dir3_1.html和/dir1/dir2/dir3_2.html规则.

# 添加缓存规则(可以为多个缓存规则)
curl -X POST "https://cdn.api.baishan.com/v2/domain/config"\
  -H 'content-type: application/json' \
  -d '{
    "token":"xxx",
    "domains":"aa.qingcdn.com",
    "config": {
        "cache_rule":[
            {
                "type":1,
                "pattern":"jpg,png,gif",
                "time":3600
            },
            {
                "type":1,
                "pattern":"avi,mp4,mpeg",
                "time":3600
            }
        ]
    }
}'

cache_rule_list (缓存规则新)

# 添加缓存规则(可以为多个缓存规则)
curl -X POST "http://cdn.api.baishan.com/v2/domain/config"\
  -H 'content-type: application/json' \
  -d '{
    "token":"xxx",
    "domains":"test.aa.qingcdn.com",
    "config": {
        "cache_rule_list":[
            {
            "match_method":"dir",
            "pattern":"/www/html,/www/aaa",
            "case_ignore":"no",
            "priority":13,
            "expire":60,
            "expire_unit":"i",
            "ignore_no_cache_headers":"yes", 
            "follow_expired":"no",
            "query_params_op":"do_nothing"
            },
            {
            "match_method":"ext",
            "pattern":"php,jsp,asp,aspx",
            "case_ignore":"no",
            "priority":15,
            "expire":3600,
            "expire_unit":"s",
            "ignore_no_cache_headers":"yes", 
            "follow_expired":"no",
            "query_params_op":"cache_back_source_remove"
            }
        ]
    }
}'

ip_black_list (ip黑名单)

# 设置ip黑名单
curl -X POST "https://cdn.api.baishan.com/v2/domain/config"\
  -H 'content-type: application/json' \
  -d '{
    "token":"xxx",
    "domains":"example.com",
    "config": {   
        "ip_black_list": {
            "list": [
                "14.12.11.0/24",
                "1.2.3.4"
            ],
            "mode": "cover"
        }
    }
}'

ip_white_list (ip白名单)

# 设置ip黑名单
curl -X POST "https://cdn.api.baishan.com/v2/domain/config"\
  -H 'content-type: application/json' \
  -d '{
    "token":"xxx",
    "domains":"example.com",
    "config": {   
        "ip_white_list": {
            "list": [
                "14.12.11.0/24",
                "1.2.3.4"
            ],
            "mode": "cover"
        }
    }
}'

add_response_head (添加响应头)

#添加响应头
curl -X POST "https://cdn.api.baishan.com/v2/domain/config"\
    -H "Content-Type: application/json"\
    -d '{
    "token":"xxx",
    "domains":"aa.qingcdn.com",
    "config": {
        "add_response_head": {
            "type":"add",
            "list":[
                {
                    "name":"Content-Type", 
                    "value":"text/html; charset=ISO-8859-4"
                },
                {
                    "name":"Cache-Control", 
                    "value":"max-age=300, must-revalidate"
                }
            ]
        }
    }
}'

#删除响应头
curl -X POST "https://cdn.api.baishan.com/v2/domain/config"\
    -H "Content-Type: application/json"\
    -d '{
    "token":"xxx",
    "domains":"aa.qingcdn.com",
    "config": {
        "add_response_head": {
            "type":"remove",
            "list":["Content-Type","Cache-Control"]
        }
    }
}'

add_back_source_head (添加回源请求头)

#添加回源请求头
curl -X POST "https://cdn.api.baishan.com/v2/domain/config"\
    -H "Content-Type: application/json"\
    -d '{
    "token":"xxx",
    "domains":"example.com",
    "config": {
        "add_back_source_head":[
            {
                "head_name":"name",
                "head_value":"value1",
                "write_when_exists":"yes"
            },
            {
                "head_name":"name2",
                "head_value":"value2",
                "write_when_exists":"no"
            }
        ]
    }
}'

https (证书配置)

# 设置https证书
curl -X POST "https://cdn.api.baishan.com/v2/domain/config"\
  -H 'content-type: application/json' \
  -d '{
    "token":"xxx",
    "domains":"example.com",
    "config": {
        "https": {
            "cert_id": 10101,
            "http2":"on",
            "force_https":"301",
            "ocsp": "on"
        }
    }
}'

visit_timestamp (时间戳防盗链)

时间戳防盗链: 在查询配置或创建成功后返回的参数中有request_style, 表示根据时间戳防盗链相关的参数进行配置后, 生成的匹配规则, 供参考用.

forbid_httpx (禁止http或https访问)

cache_error_code (错误状态码缓存)

video_drag (视频拖拉)

compress_response (压缩响应)

speed_limit（单链接限速）

配置生效方式：覆盖式更新

规则总数：最多只能有100条规则。

限速时间：结束时间必须大于开始时间

限速值：会转换为 KB，并向上取整，比如填入 12 kbps，则生效的限速值为 2KB

URL匹配正则使用说明 : 正则规则是作为一般类型无法满足情形下的补充, 使用不当会引起限速规则不必要的故障, 建议有一定正则基础的开发者使用, 请理解清楚正则的使用规则后再应用到线上服务中, 设置URL匹配规则为正则, 会将请求的url地址(url地址:包含http/https协议部分、域名、端口[有的话]、路径、参数等几个部分)与正则去做匹配, 匹配成功则会使用该规则设定的限速规则.

1. 举例1: .*\.(gif|png|jpg)$, 那么他将匹配所有含(gif,png,jpg)文件名后缀的url
2. 举例2: ^https?://[^/]+/dir1/dir2/(dir3_1|dir3_2)\.html, 该规则匹配当前域名下/dir1/dir2/dir3_1.html和/dir1/dir2/dir3_2.html规则.

#添加单链接限速
curl -X POST "https://cdn.api.baishan.com/v2/domain/config"\
    -H "Content-Type: application/json"\
    -d '{
    "token":"xxx",
    "domains":"aa.qingcdn.com",
    "config": {
        "speed_limit": [
            {
                "type":"ext",
                "speed":"80",
                "begin_time":"12:00",
                "end_time":"13:00",
                "pattern":"jpg"
            }
        ]
    }
}'

visit_deny_whitelist (防盗链白名单)

#添加防盗链白名单
curl -X POST "https://cdn.api.baishan.com/v2/domain/config"\
    -H "Content-Type: application/json"\
    -d '{
    "token":"xxx",
    "domains":"aa.qingcdn.com",
    "config": {
        "visit_deny_whitelist": [
            {"url":"/user/get?index","turn_on":true},
            {"url":"/contract/get?index","turn_on":true}
        ]
    }
}'

#删除防盗链白名单
curl -X POST "https://cdn.api.baishan.com/v2/domain/config"\
    -H "Content-Type: application/json"\
    -d '{
    "token":"xxx",
    "domains":"aa.qingcdn.com",
    "config": {
        "visit_deny_whitelist": [
            {"url":"/user/get?index","turn_on":false},
            {"url":"/contract/get?index","turn_on":false}
        ]
    }
}'

防盗链白名单设置成功后会输出对应设置成功后的配置参数

{
    "code": 0,//0操作成功, 非0时会给出对应的错误提示
    "data": {
        "config": {
            "visit_deny_whitelist": {
                "url": [
                "/user/get?index",
                "/contract/get?index"
                ]
            },
            ...
        }
    }
}

range_back_source (分片回源 )

curl -X POST "http://cdn.api.baishan.com/v2/domain/config"\
  -H 'content-type: application/json' \
  -d '{
    "token":"xx",
    "domains":"aa.qingcdn.com",
    "config": {
        "range_back_source":"off"
    }
}'

extend (Squid扩展配置)

#Squid扩展配置
curl -X POST "https://cdn.api.baishan.com/v2/domain/config"\
    -H "Content-Type: application/json"\
    -d '{
    "token":"xxx",
    "domains":"aa.qingcdn.com",
    "config": {
        "extend":{
            "squid":"acl url_host url_regex -i ^https?://[^/]+/[^/]*c_scale.*\r\ncache_peer_access xuntiku-static allow !url_host"
        }
    }
}'

rate_limit (限速)

#Squid扩展配置
curl -X POST "https://cdn.api.baishan.com/v2/domain/config"\
    -H "Content-Type: application/json"\
    -d '{
    "token":"xxx",
    "domains":"aa.qingcdn.com",
    "config": {
        "rate_limit": {
            "max_rate_count":10
        }
    }
}'

new_origin (域名源（新）)

特殊说明 :

1.和域名源/回源HOST 子服务和此子服务配置存在冲突，该子服务的优先级更高
2.当host配置为空且配置有回源HOST有配置时，以回源HOST为准
3.该子服务优先级低于拓展配置
4.配置是覆盖模式，当前不支持追加

curl -X POST "https://cdn.api.baishan.com/v2/domain/config"\
    -H "Content-Type: application/json"\
    -d '{
    "token": "xxx",
    "domains": "aa.qingcdn.com",
    "config": {
        "new_origin": [
            {
                "origin": "1.1.1.1",
                "port": 80,
                "protocol": "http",
                "host": "example.com",
                "level": 20,
                "weight_level": 1,
                "isp": "default"
            }
        ]
    }
}'

cache_share (共用缓存)

curl -X POST "https://cdn.api.baishan.com/v2/domain/config"\
    -H "Content-Type: application/json"\
    -d '{
    "token":"xxx",
    "domains":"aa.qingcdn.com",
    "config": {
        "cache_share": {
              "share_way": "cross_single_share",
              "domain": "bb.qingcdn.com"
        }
    }
}'

head_control (HTTP头控制)

curl -X POST "https://cdn.api.baishan.com/v2/domain/config"\
    -H "Content-Type: application/json"\
    -d '{
    "token":"xxx",
    "domains":"aa.qingcdn.com",
    "config": {
        "head_control": {
            "list": [
                {
                    "regex": ".*",
                    "head_op": "ADD",
                    "head_direction": "CLI_REQ",
                    "head": "test_header",
                    "value": "X-test",
                    "order": 1
                }
            ]
        }
    }
}'

timeout (回源读超时时间)

curl -X POST "https://cdn.api.baishan.com/v2/domain/config"\
    -H "Content-Type: application/json"\
    -d '{
    "token":"xxx",
    "domains":"aa.qingcdn.com",
    "config": {
        "timeout": {
              "time": "6"
        }
    }
}'

connect_timeout (回源建联超时时间)

curl -X POST "https://cdn.api.baishan.com/v2/domain/config"\
    -H "Content-Type: application/json"\
    -d '{
    "token":"xxx",
    "domains":"aa.qingcdn.com",
    "config": {
        "connect_timeout": {
              "origin_connect_timeout": "10"
        }
    }
}'

qiniu_origin_auth (七牛回源鉴权)

curl -X POST "https://cdn.api.baishan.com/v2/domain/config"\
    -H "Content-Type: application/json"\
    -d '{
    "token":"xxx",
    "domains":"test.com",
    "config": {
        "qiniu_origin_auth": {
            "auth_url": "http://test.com/",
            "match_method": "ext",
            "pattern": "jpg,web,html"
        }
    }
}'

forward_status (继续取跳转后内容)

# 添加继续取跳转后内容
curl -X POST "https://cdn.api.baishan.com/v2/domain/config"\
  -H 'content-type: application/json' \
  -d '{
    "token":"xxx",
    "domains":"aa.qingcdn.com",
    "config": {
            "forward_status" : {
            "codes": [
                301,
                302
            ]
        }
    }
}'

cache_error_code (错误状态码缓存)

# 错误状态码缓存
curl -X POST "https://cdn.api.baishan.com/v2/domain/config"\
  -H 'content-type: application/json' \
  -d '{
    "token": "xxx",
    "domains": "aa.qingcdn.com",
    "config": {
        "cache_error_code" : {
            "code": [
                "403"
            ],
            "bcache": "off"
        }
    }
}'

调用示例

curl -X POST "https://cdn.api.baishan.com/v2/domain/config"\
    -H "Content-Type: application/json"\
    -d '{
    "token":"xxx",
    "domains":"aa.qingcdn.com,bb.qingcdn.com",
    "config": {
        "origin": {
            "default_master": "133.233.133.33",
            "default_slave": "12.13.41.21"
        },
        "origin_host": {
            "host": "test.qingcdn.com"
        },
        "referer": {
            "type": 1,
            "list": [
                "*.qingcdn.com",
                "new.vx.qingcdn.com"
            ],
            "allow_empty": false
        },
        "ip_black_list": {
            "list": [
                "14.12.11.0/24",
                "1.2.3.1"
            ]
        },
        "ip_white_list": {
            "list": [
                "14.12.11.0/24",
                "1.2.3.1"
            ]
        },
        "add_response_head":{
            "type":"add",
            "list":[
                {
                    "name":"Content-Type", 
                    "value":"text/html; charset=ISO-8859-4"
                },
                {
                    "name":"Cache-Control", 
                    "value":"max-age=300, must-revalidate"
                }
            ]
        },
        "https":{
            "cert_id":123
        },
        "visit_timestamp": {
            "pattern": ".*",
            "time_format": "timestamp",
            "key": "c3RyaWN0b",
            "keyname": "sign",
            "timename": "time",
            "deadtime": "3600",
            "req_uri_type": "2",
            "origin_type": "2",
            "error_page": "",
            "style": "$ourkey$uri$time"
        },
        "cache_rule": [
            {
                "type": "2",
                "pattern": "/product/index,/test/index,/user/index",
                "time": 86400,
                "timeunit": "s"
            },
            {
                "type": "1",
                "pattern": "jpg,png,gif",
                "time": 86400,
                "timeunit": "s"
            },
            {
                "type": "3",
                "pattern": "/index.html,/test/*.jpg,/user/get?index",
                "time": 86400,
                "timeunit": "s"
            }
        ],
        "video_drag": {
            "url": "\\.(mp4|flv|f4v|m4v)",
            "mp4": "off",
            "flv": "off",
            "start": "start",
            "end": "end"
        },
        "compress_response": {
            "content_type": [
                "text/plain",
                "application/x-javascript"
            ],
            "min_size": "2",
            "min_size_unit": "KB"
        }
    }
}'

返回示例

JSON格式(请求时传对应的参数, 设置成功后会输出对应设置成功后的配置参数)

{
    "code": 0,//0操作成功, 非0时会给出对应的错误提示
    "data": {
        "config": {
            "origin": {
                "default_master": "133.233.133.33",
                "default_slave": "12.13.41.21"
            },
            ...
        }
    }
}

error_page_rewrite (自定义错误页面)

调用示例

curl -X POST 'http://cdn.api.baishan.com/v2/domain/config' \
--header 'content-type: application/json' \
-d '{
    "domains": "a.baishan.com",
    "token": "xxxxxx",
    "config": {
        "error_page_rewrite": [
            {
                "error_status_code": 400,
                "redirect_url": "http://a.baishan.com/err.html",
                "redirect_status_code": 301
            }
        ]
    }
}'

post_upload_size_limit (post上传大小限制)

调用示例

curl -X POST 'http://cdn.api.baishan.com/v2/domain/config' \
--header 'content-type: application/json' \
-d '{
    "domains": "a.baishan.com",
    "token": "xxxxxx",
    "config": {
        "post_upload_size_limit": {
            "limit_value": 30
        }
    }
}'

source_url_rewrite (回源URL改写)

调用示例

curl -X POST 'http://cdn.api.baishan.com/v2/domain/config' \
--header 'content-type: application/json' \
-d '{
    "domains": "a.baishan.com",
    "token": "xxxxxx",
        "config": {
        "source_url_rewrite": [
            {
                "origin_url": "/aaa/(*).html",
                "target_url": "/bbb/$1"
            }
        ]
    }
}'

combined_ban (Combined-Ban组合封禁)

备注：combined_ban [] 里面 每一个{} 表示一条规则，configs 里面 每个封禁类型配置 对应组合的封装项

组合封禁优先级说明 : 优先级按规则数组排序，由高至低排序

组合封禁类型说明 : 一组{}规则，configs里面的method、ip、referer、url、ua，封禁类型不能重复

组合封禁规则名单列表使用说明 :

1.ip列表 正常的IP地址，支持/8，/16，/24格式的网段设置，网段不能存在交叉重复.

例如: ["1.1.1.0/24", "2.2.2.2", "3.3.3.3"]

2.referer列表，默认模糊匹配，不区分大小写.

例如: ["*.aaa.qingcdn.com", "www.qingcdn.com","*.test.com"]

3.url列表,支持正则表达式，传入的内容默认是模糊匹配，精确匹配需要加上^$

例如：

模糊匹配：http://.www.ttt1.com/1.txt

精确匹配：^https?://[^/]+/dir1/dir2/(dir3_1|dir3_2).html$

该规则匹配当前域名下/dir1/dir2/dir3_1.html和/dir1/dir2/dir3_2.html规则.

4.ua列表，传入的内容默认是模糊匹配，精确匹配需要加上^$ 。

例如: 模糊匹配: test-yp, 精确匹配: ^test-yp$

输入示例

{
    "domains": "testxx.xxx.com",
    "config": {
        "combined_ban": [
          //第一条规则 配置ua、url、referer组合封禁
            {
                "action": "ban",
                "configs": {
                    "ua": {
                        "is_match": "yes",
                        "case_insensitive": "yes",
                        "list": [
                            "^test\\-yp$",
                            "test\\.com"
                        ]
                    },
                    "url": {
                        "is_match": "yes",
                        "case_insensitive": "yes",
                        "list": [
                            "^http://.www.ttt1.com/1.txt",
                            "http://.www.ttt2.com/2.txt",
                            "^http://[^/]+www.ttt2.com/2.txt"
                        ]
                    },
                    "referer": {
                        "is_match": "no",
                        "list": [
                            "www.baidu.com",
                            "test.test.com"
                        ]
                    }
                }
            },
            //第二条规则 method（请求方式）、ip组合封禁
            {
                "action": "ban",
                "configs": {
                    "method": {
                        "is_match": "yes",
                        "method_type": "post"
                    },
                    "ip": {
                        "is_match": "yes",
                        "list": [
                            "2.2.2.2",
                            "1.1.1.1"
                        ]
                    }
                }
            },
            //第二条规则 method（请求方式）组合封禁
            {
                "action": "ban",
                "configs": {
                    "method": {
                        "is_match": "no",
                        "method_type": "get"
                    }
                }
            }
        ]
    }
}

返回示例

JSON格式(请求时传对应的参数, 设置成功后会输出对应设置成功后的配置参数)

备注：combined_ban [] 里面 每一个{} 表示一条规则，configs 里面 每个封禁类型配置 对应组合的封装项

{
    "code": 0,//0操作成功, 非0时会给出对应的错误提示
    "domains": [
            {
                "id": "310649",
                "domain": "testxx.xxx.com"
            }
        ],
    "data": {
        "config": {
            "combined_ban": [
              //第一条规则
                {
                    "action": "ban",
                    "configs": {
                        "ua": {
                            "is_match": "yes",
                            "case_insensitive": "yes",
                            "list": [
                                "^test\\-yp$",
                                "test\\.com"
                            ]
                        },
                        "referer": {
                            "is_match": "no",
                            "list": [
                                "www.baidu.com",
                                "test.test.com"
                            ]
                        },
                        "url": {
                            "is_match": "yes",
                            "case_insensitive": "yes",
                            "list": [
                                "^http://.www.ttt1.com/1.txt",
                                "http://.www.ttt2.com/2.txt",
                                "^http://[^/]+www.ttt2.com/2.txt"
                            ]
                        }
                    }
                },
                //第二条规则
                {
                    "action": "ban",
                    "configs": {
                        "ip": {
                            "is_match": "yes",
                            "list": [
                                "2.2.2.2",
                                "1.1.1.1"
                            ]
                        },
                        "method": {
                            "is_match": "yes",
                            "method_type": "post"
                        }
                    }
                },
                //第三条规则
                {
                    "action": "ban",
                    "configs": {
                        "method": {
                            "is_match": "no",
                            "method_type": "get"
                        }
                    }
                }
            ]
        }
    }
}

deny_url (屏蔽非法URL)

调用示例

curl -X POST 'http://cdn.api.baishan.com/v2/domain/config' \
--header 'content-type: application/json' \
-d '{
    "domains": "a.baishan.com",
    "token": "xxxxxx",
        "config": {
           "deny_url": {
             "urls": [
                "http://www.test.com/5.txt",
                "^http://[^/]+www.ttt2.com/2.txt",
                "^https?://[^/]+/test1/test2\\?cd=sad($|\\?)"
            ]
        }
    }
}'

返回示例

JSON格式(请求时传对应的参数, 设置成功后会输出对应设置成功后的配置参数)

{
    "code": 0,
    "data": {
        "domains": [
            {
                "id": "123",
                "domain": "a.baishan.com"
            }
        ],
        "config": {
            "deny_url": {
                "urls": [
                    "http://www.test.com/5.txt",
                    "^http://[^/]+www.ttt2.com/2.txt",
                    "^https?://[^/]+/test1/test2\\?cd=sad($|\\?)"
                ]
            }
        }
    }
}

tos_origin (tos域名源)

调用示例

curl -X POST 'https://cdn.portal.baishan.com/v2/domain/config?token=xxx' \
--header 'Content-Type: application/json' \
-d '{
    "domains": "www.test.com",
    "config": {
        "tos_origin": [
            {//第一条
                "isp": "default",
                "group_sort": 3,
                "ips": [
                    "www.text1.com",
                    "www.text2.com"
                ],
                "origin_mode": "default"
            },
            {//第二条
                "isp": "default",
                "port": 443456,
                "group_sort": 1,
                "weight": 1000,
                "auth_expire": 600,
                "ips": [
                    "1.1.1.1"
                ],
                "protocol": "httpsav",
                "host": "www.test.com",
                "auth_bucket_name": "",
                "auth_secret_key": "xxx",
                "auth_access_key": "xxx",
                "auth_cdn_tag": "xxxx",
                "origin_mode": "custom",
                "host_mode": "custom",
                "auth_type": "tos",
                "parse_priority": "v4v6"
            }
        ]
    }
}'

返回示例

{
    "code": 0,
    "data": {
        "domains": [
            {
                "id": "56784",
                "domain": "www.test.com"
            }
        ],
        "config": {
            "tos_origin": [
                {//第一条
                    "isp": "default",
                    "group_sort": 3,
                    "ips": [
                        "www.text1.com",
                        "www.text2.com"
                    ],
                    "origin_mode": "default"
                },
                {//第二条
                    "isp": "default",
                    "port": 443456,
                    "group_sort": 1,
                    "weight": 1000,
                    "auth_expire": 600,
                    "ips": [
                        "1.1.1.1"
                    ],
                    "protocol": "httpsav",
                    "host": "www.test.com",
                    "auth_bucket_name": "",
                    "auth_secret_key": "xxx",
                    "auth_access_key": "xxx",
                    "auth_cdn_tag": "xxxx",
                    "origin_mode": "custom",
                    "host_mode": "custom",
                    "auth_type": "tos",
                    "parse_priority": "v4v6"
                }
            ]
        }
    }
}

client_real_ip (客户端真实ip)

调用示例

curl -X POST 'https://cdn.portal.baishan.com/v2/domain/config?token=xxx' \
--header 'Content-Type: application/json' \
-d '{
    "token": "{{token}}",
    "domains": "www.example.com",
    "config": {
        "client_real_ip": {
            "head":"xxx-xxx-xxx"
        }
    }
}'

user_agent (User-Agent黑白名单)

调用示例：

curl -X POST 'https://cdn.portal.baishan.com/v2/domain/config?token=xxx' \
--header 'Content-Type: application/json' \
-d '{
    "token": "{{token}}",
    "domains": "www.example.com",
    "config": {
        "user_agent": {
            "ua_type": "black",
            "allow_empty_ua": "no",
            "ua_match_type": "pattern",
            "ua_list": "curl\nCurl\nwget\nWget\ngo\nGo",
            "ua_case_insensitive": "yes",
            "url_case_insensitive": "yes",
            "url_match_type": "all",
            "url_pattern": ".*"
        }
    }
}'

响应示例：

{
    "code": 0,
    "data": {
        "domains": [
            {
                "id": "1",
                "domain": "www.example.com"
            }
        ],
        "config": {
            "user_agent": {
                "ua_list": "curl\nCurl\nwget\nWget\ngo\nGo",
                "url_pattern": ".*",
                "url_case_insensitive": "yes",
                "allow_empty_ua": "no",
                "ua_case_insensitive": "yes",
                "url_match_type": "all",
                "ua_type": "black",
                "ua_match_type": "pattern"
            }
        }
    }
}

visit_areas_limit (访问区域黑白名单)

# 访问区域黑白名单
curl -X POST "https://cdn.api.baishan.com/v2/domain/config"\
  -H 'content-type: application/json' \
  -d '{
    "token": "xxx",
    "domains": "aa.qingcdn.com",
    "config": {
        "visit_areas_limit" : {
            "limit_type": "white",
            "country_list": "china"
        }
    }
}'

响应(Response Header)

HTTP/1.0 200 OK
Api-Id: 221328331
Content-Type: application/json; charset=utf-8
X-Ratelimit-Grad: minute   //接口调用频率限制粒度(分/小时/天)
X-Ratelimit-Limit: 50      //当前每分钟请求次数上限
X-Ratelimit-Remaining: 29  //每分钟剩余请求次数
X-Retry-After: 43          //xx秒后重置当前粒度(分/小时/天)请求次数限制

http状态码说明