CDN V1.1

添加域名(20230518)

开发中

开发环境

http://39.100.59.112:8000

POST

/domain

向DNS服务添加解析，将域名解析到指定的节点，若未指定则解析到源站，等待后续配置

向ETCD中指定节点配置添加初始化配置（默认防火墙配置、默认缓存配置等）

域名及其配置存入数据库，用于查询

选择四层还是七层转发

支持泛域名、域名检查、域名备案

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

string

必需

默认值:

application/json

Body 参数application/json

domain

string

加速域名

必需

config_list

array [object {10}]

七层配置列表

必需

protocol

string

代理协议

可选

port

integer

代理端口

可选

uri_forward

string

uri转发

可选

redirect

boolean

301跳转

可选

1/0

overload_type

integer

并发超限类型

必需

1:400阻断；2:301跳转；3:自定义

overload_status_code

integer

并发超限阻断状态码

必需

overload_redirect_url

string

并发超限跳转

必需

填写的跳转地址需要带协议，如 https://www.jd.com

load_balancing

integer

负载均衡

必需

(0, "Equaly"), (1, "Weight"), (2, "IPHash"), (3, "URLHash")

server

string

必需

source_addresses

array [object {6}]

源地址

可选

primary_domain

string

主域名

必需

生成二级域名的主域名

domain_config

object

域名相关配置

必需

cache_total_size_limit

integer

必需

缓存文件整体容量限制，单位KB

cache_file_size_limit

integer

必需

缓存单文件容量限制，单位KB

nodes

array [object {3}]

节点列表

必需

node_uuid

string

节点uuid

必需

priority

integer

优先级

必需

解析至最大的一个节点

node_type

string

主备标记

必需

primary/backup 二选一

four_layers_config

array [object {10}]

四层转发配置

必需

protocol

string

协议

可选

tcp/udp

tcp_version

integer

TCP版本

可选

仅TCP协议下填写，写1即可（弃用，为保证兼容，建议仍然填写1）

port

integer

端口号

可选

max_connection

string

最大并行连接数

必需

设置（更新）特定 uuid 的最大连接数 0则不限制

new_connection

string

新建连接数量限制

必需

设置（更新）特定 uuid 的新建连接数 0则不限制

load_balancing

string

负载均衡

必需

(0, "Equaly"), (1, "Weight")

health_check_active

boolean

可选

是否进行健康检查，仅对tcp生效，默认为false

source_address

array [object {3}]

源地址

可选

proxy_protocol

integer

转发真实IP

必需

是否转发真实IP，0-不转发 1-使用明文转发 2-使用密文转发

rate_limit

integer

可选

仅对udp生效，UDP发包频率限制，单位（次/秒），可以不填写将不限制发包频率若填0，也不限制发包频率

示例

{
    "domain": "string",
    "config_list": [
        {
            "protocol": "string",
            "port": 0,
            "uri_forward": "string",
            "redirect": true,
            "overload_type": 0,
            "overload_status_code": 0,
            "overload_redirect_url": "string",
            "load_balancing": 0,
            "server": "string",
            "source_addresses": [
                {
                    "address": "string",
                    "protocol": "string",
                    "concurrent": 0,
                    "weight": 0,
                    "port": 0,
                    "sni": "string"
                }
            ]
        }
    ],
    "primary_domain": "string",
    "domain_config": {
        "cache_total_size_limit": 0,
        "cache_file_size_limit": 0
    },
    "nodes": [
        {
            "node_uuid": "string",
            "priority": 0,
            "node_type": "string"
        }
    ],
    "four_layers_config": [
        {
            "protocol": "string",
            "tcp_version": 0,
            "port": 0,
            "max_connection": "string",
            "new_connection": "string",
            "load_balancing": "string",
            "health_check_active": true,
            "source_address": [
                {
                    "address": "string",
                    "port": 0,
                    "weight": 0
                }
            ],
            "proxy_protocol": 0,
            "rate_limit": 0
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://39.100.59.112:8000/domain' \
--header 'Accept;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "domain": "string",
    "config_list": [
        {
            "protocol": "string",
            "port": 0,
            "uri_forward": "string",
            "redirect": true,
            "overload_type": 0,
            "overload_status_code": 0,
            "overload_redirect_url": "string",
            "load_balancing": 0,
            "server": "string",
            "source_addresses": [
                {
                    "address": "string",
                    "protocol": "string",
                    "concurrent": 0,
                    "weight": 0,
                    "port": 0,
                    "sni": "string"
                }
            ]
        }
    ],
    "primary_domain": "string",
    "domain_config": {
        "cache_total_size_limit": 0,
        "cache_file_size_limit": 0
    },
    "nodes": [
        {
            "node_uuid": "string",
            "priority": 0,
            "node_type": "string"
        }
    ],
    "four_layers_config": [
        {
            "protocol": "string",
            "tcp_version": 0,
            "port": 0,
            "max_connection": "string",
            "new_connection": "string",
            "load_balancing": "string",
            "health_check_active": true,
            "source_address": [
                {
                    "address": "string",
                    "port": 0,
                    "weight": 0
                }
            ],
            "proxy_protocol": 0,
            "rate_limit": 0
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

data

object (节点信息（全量）)

必需

integer

必需

primary_ip

string

主IP（20230429新增）

必需

主IP

node_ip

array [object {3}]

必需

node_name

string

名称

必需

node_uuid

string

节点uuid

必需

alive

boolean

节点存活性（20230429新增）

必需

True-存活 False-不存活

示例

{
    "code": 0,
    "message": "string",
    "data": {
        "id": 0,
        "primary_ip": "string",
        "node_ip": [
            {
                "node_ip": "string",
                "isp": "string",
                "connectivity": true
            }
        ],
        "node_name": "string",
        "node_uuid": "string",
        "alive": true
    }
}

查询域名列表(20230518)

删除域名