请求URL: domain (POST)
接口请求域名:
cdn.api.baishan.com
接口版本:v2
创建域名,同时支持添加功能配置项:回源地址、回源host。
注意:
特殊账号使用该接口时,需要添加请求参数用户ID,否则报错提示:user_id is require。
如需使用请联系项目经理申请开通。
公有参数:用户的 token 可向值班同事获取。
参数支持 form-data、x-www-form-urlencoded、json 等格式
| 参数名 | 数据类型 | 是否必须 | 说明 |
|---|---|---|---|
| domain | string | 是 | 需要创建的加速域名 |
| area | string | 否 | 加速区域:mainland_china:中国境内outside_mainland_china:中国境外global :全球。 合同未签约的加速区域将导致域名创建失败。 |
| type | string | 是 | 域名类型:page:网页download:下载video_demand:点播dynamic:动态 |
| config | object | 是 | 功能配置项, 支持回源地址和回源host的设置。 |
| 参数名 | 数据类型 | 是否必须 | 说明 |
|---|---|---|---|
| default_master | string | 是 | 主回源, 可填ip, 域名, 多个以逗号(,)分隔 例如: "133.233.133.33,133.233.22.33", 主源/备源最多6个ip |
| default_slave | string | 否 | 备回源, 可填ip, 域名, 多个以逗号(,)分隔 例如: "133.233.133.33,133.233.22.33" 注:主备源不可设置为一样, 不可与主源存在重复 |
| origin_mode | string | 否 | 回源方式:default:以用户访问的协议和端口回源http:http协议80端口回源https:https协议443端口回源custom:自定义协议和端口回源,需要设置ori_https和port参数。不填充时,默认值为default。 |
| ori_https | string | 是 | 当origin_mode=custom时, 需要设置。是否https协议回源: yes:是no:否 |
| port | int | 是 | 当origin_mode=custom时, 需要设置。回源端口,可选值范围:(0-65535) |
| 参数名 | 数据类型 | 是否必须 | 说明 |
|---|---|---|---|
| host | string | 是 | 回源host |
curl -X POST "https://cdn.api.baishan.com/v2/domain?token=xxx"\
-H "Content-Type: application/json"\
-d '{
"domain":"example.com",
"type":"page",
"config":{
"origin":{
"default_master":"1.1.1.1"
},
"origin_host":{
"host":"test.qingcdn.com"
}
}
}'json格式
{
"code": 0, //code为0,表示数据返回正常,非0时则不正常
"data": {
"id": "2729151231",
"domain": "example.com",
"type": "page",
"status": "deploying",
"cname": "example.com.qingcdn.com.",
"config": {
"origin": {
"default_master": "1.1.1.1."
},
"origin_host":{
"host":"test.qingcdn.com"
}
}
}
}HTTP/1.0 200 OK
Api-Id: 100438085
Content-Type: application/json; charset=utf-8
X-Ratelimit-Grad: minute
X-Ratelimit-Limit: 100
X-Ratelimit-Remaining: 100
X-Retry-After: 1S3 回源(对象存储源):加速域名支持以 AWS S3 存储桶作为回源源站。该功能需要独立开通权限,未授权客户调用将返回 401002 权限错误,如需使用请联系项目经理申请开通。
| 参数名 | 数据类型 | 是否必须 | 说明 |
|---|---|---|---|
| region | string | 是 | S3 存储地域,如 ap-southeast-1 |
| access_keyid | string | 是 | S3 AccessKey ID,仅允许字母数字及 .*-_,不含空格 |
| secret | string | 是 | S3 AccessKey Secret,仅允许字母数字及 .*-_,不含空格 |
| host | string | 是 | S3 回源域名,如 bucket.s3.amazonaws.com |
注意:以上 4 个参数必须全部填写。
curl -X POST "https://cdn.api.baishan.com/v2/domain?token=xxx"\
-H "Content-Type: application/json"\
-d '{
"domain":"example.com",
"type":"page",
"config":{
"origin":{
"default_master":"1.1.1.1"
},
"object_storage_source":{
"region":"ap-southeast-1",
"access_keyid":"AKIDxxxxxxxxxx",
"secret":"xxxxxxxxxx",
"host":"bucket.s3.amazonaws.com"
}
}
}'{
"code": 0, //code为0,表示数据返回正常,非0时则不正常
"data": {
"id": "2729151231",
"domain": "example.com",
"type": "page",
"status": "deploying",
"cname": "example.com.qingcdn.com.",
"config": {
"origin": {
"default_master": "1.1.1.1."
},
"object_storage_source": {
"region": "ap-southeast-1",
"access_keyid": "AKIDxxxxxxxxxx",
"secret": "xxxxxxxxxx",
"host": "bucket.s3.amazonaws.com"
}
}
}
}