更新时间:2023-09-15 17:02:13
1.新增域名
接口描述
用于添加域名。CloudDNS支持批量添加多个域名。秒级生效。
限制说明:
1.建议调用频率不超过240次/分钟。
2.域名必须不包含如下信息:出售药物和管制刀具类,含有不法言论、信息。
3.视频类域名必须有视听许可证;博客论坛或社区类加速域名必须有BBS专项审批资质。
鉴权方法:见概览页公共鉴权示例。
请求参数
参数 类型 必填 描述
domainName string 是 添加的域名,如果添加多个域名,用英文半角分号分隔。
language string 否 为空返回中文结果(默认),en:返回英文提示结果
返回参数
参数 类型 描述
resCode string 状态码,详细说明请参见“业务状态码”。
msg string 状态码的详细说明。
content List 域名的详细说明。
请求示例
#!/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/clouddns/AddDomain”
-X “POST”
-u “$username:$password”
-H “Date: $date”
-H “Accept: application/json”
-d ‘{
“domainName”: “earth12.com.cn;youth.com;k45.com”
}’
响应示例
{
“resCode”:0,
“msg”:“操作成功”,
“content”: [
{
“domainId”:6203,
“domainName”:“earth12.com.cn”,
“ret”:“Success”,
“msg”:“操作成功”,
“msgEn”:null,
“result”:null,
“code”:0,
“success”:true
},
{
“domainId”:6204,
“domainName”:“youth.com”,
“ret”:“Success”,
“msg”:“操作成功”,
“msgEn”:null,
“result”:null,
“code”:0,
“success”:true
},
{
“domainId”:6205,
“domainName”:“k45.com”,
“ret”:“Success”,
“msg”:“操作成功”,
“msgEn”:null,
“result”:null,
“code”:0,
“success”:true
}
]
}
2.删除域名
接口描述
用于批量删除域名。秒级生效。
限制说明:
1.建议调用频率不超过240次/分钟。
2.域名必须不包含如下信息:出售药物和管制刀具类,含有不法言论、信息。
3.视频类域名必须有视听许可证;博客论坛或社区类加速域名必须有BBS专项审批资质。
鉴权方法:见概览页公共鉴权示例。
请求参数
参数 类型 必填 描述
domainName string 是 删除的域名
如果需要删除多个域名,用英文半角分号分隔。
language string 否 为空返回中文结果(默认)
en:返回英文提示结果
返回参数
参数 类型 描述
resCode string 状态码,resCode的详细说明请参见“业务状态码”。
msg string 状态码的详细说明。
content List 域名的详细说明。
domainId 域名ID
domainName 域名名称
ret 成功或失败标识
msg 成功或失败提示
msgEn 成功或失败提示
请求示例
#!/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/clouddns/DelDomain”
-X “POST”
-u “$username:$password”
-H “Date: $date”
-H “Accept: application/json”
-d ‘{
“domainName”: “earth12.com.cn;youth.com;k45.com”
}’
响应示例
{
“resCode”:0,
“msg”:“操作成功”,
“content”: [
{
“domainId”:6203,
“domainName”:“earth12.com.cn”,
“ret”:“Success”,
“msg”:“删除成功”,
“msgEn”:“delete success”,
“result”:null,
“code”:0,
“success”:true
},
{
“domainId”:6204,
“domainName”:“youth.com”,
“ret”:“Success”,
“msg”:“删除成功”,
“msgEn”:“delete success”,
“result”:null,
“code”:0,
“success”:true
},
{
“domainId”:6205,
“domainName”:“k45.com”,
“ret”:“Success”,
“msg”:“删除成功”,
“msgEn”:“delete success”,
“result”:null,
“code”:0,
“success”:true
}
]
}
3.查询域名
接口描述
用于查询用户的域名及域名信息。建议调用频率1200次/5min。
请求参数
参数 类型 必填 描述
domainName String 否 如果没有填写域名,则返回该用户的所有域名及域名相应信息。
pageIndex int 否 分页查询页码(从1开始),为空则默认为1
pageSize int 否 分页查询条数,为空默认为1万条
language string 否 为空返回中文结果(默认)
en:返回英文提示结果
返回参数
参数 类型 描述
resCode string 状态码。
msg string 状态码的详细说明。
content List,map List:兼容旧版本,入参不含分页参数,则content为list,且不返回总条数
map:入参含分页参数,则content为map,且返回总条数
返回参数包含:
domainId、domainName、adoptState、remark…
domainId int 域名id
domainName string 域名
adoptState List 接管状态。其中:1表示已接管,0表示未接管。
remark string 备注
state int 域名状态: 2/正常,3/停止,8/正常锁定,9/停止锁定
ttl int soa ttl
serialNumber int soa序列号
email string soa邮箱
请求示例
#!/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/clouddns/QueryDomains”
-X “POST”
-u “$username:$password”
-H “Date: $date”
-H “Accept: application/json”
-d ‘{
“domainName”: “”,
“pageIndex”:1,
“pageSize”:10
}’
响应示例
示例1:兼容旧版本,入参不含分页参数,则content为list,且不返回总条数
{
“resCode”:0,
“msg”:“操作成功”,
“content”: [
{
“domainId”:7427,
“domainName”:“hahha.com”,
“adoptState”:0,
“remark”:"",
“state”:8
},
{
“domainId”:7497,
“domainName”:“asdfasddf.com”,
“adoptState”:0,
“remark”:"",
“state”:2
}
]
}
示例2:入参含分页参数,则content为map,且返回总条数
{
“resCode”:0,
“msg”:“操作成功”,
“content”: {
“count”:2,
“rows”:[
{
“domainId”:7427,
“domainName”:“hahha.com”,
“adoptState”:0,
“remark”:"",
“state”:8
},
{
“domainId”:7497,
“domainName”:“asdfasddf.com”,
“adoptState”:0,
“remark”:"",
“state”:2,
}
]
}
}
4.启停域名
接口描述
用于批量启停域名。秒级生效。
限制说明:
1.建议调用频率不超过240次/分钟。
2.域名必须不包含如下信息:出售药物和管制刀具类,含有不法言论、信息。
3.视频类域名必须有视听许可证;博客论坛或社区类加速域名必须有BBS专项审批资质。
鉴权方法:见概览页公共鉴权示例。
请求参数
参数 类型 必填 描述
domainName String 是 域名 多个域名用英文符号;隔开(如: aaa.com;bb.com)
operate Int 是 操作:1 启用;0 停用
language string 否 为空返回中文结果(默认)
en:返回英文提示结果
返回参数
参数 类型 描述
resCode Int 状态码
msg String 状态码详细说明
content List domainId 域名ID
domainName 域名
code 状态码
msg 状态码详细说明
请求示例
#!/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/clouddns/ControlDomain”
-X “POST”
-u “$username:$password”
-H “Date: $date”
-H “Accept: application/json”
-d ‘{
“domainName”:“earth12.com.cn;domain.com”,
“operate”:1
}’
响应示例
{
“resCode”:0,
“msg”:“操作成功”,
“content”: [
{
“domainId”:231007,
“domainName”:“domain.com”,
“code”:0,
“msg”:“启动成功”
},
{
“domainId”:231008,
“domainName”:“domaiaa.com”,
“code”:0,
“msg”:“启动成功”
}
]
}