域名相关¶
添加新域名¶
- 接口地址：
- HTTP请求方式：
- POST
- 请求参数：
参数名 是否必须 参数描述 公共参数 是 详见：公共参数 domain 是 域名, 没有 www, 如 dnspod.com group_id 否 域名分组ID, 可选参数 is_mark 否 是否星标域名，”yes”、”no” 分别代表是和否 - 响应代码：
- 共通返回
- 6 域名无效
- 7 域名已存在
- 11 域名已经存在并且是其它域名的别名
- 12 域名已经存在并且您没有权限管理
- 41 网站内容不符合DNSPod解析服务条款, 域名添加失败
示例:
curl -X POST https://dnsapi.cn/Domain.Create -d 'login_token=LOGIN_TOKEN&domain=api2.com&format=json'
返回参考：
JSON:
{ "status": { "code":"1", "message":"Action completed successful", "created_at":"2015-01-18 22:12:35" }, "domain": { "id":"1992403", "punycode":"api2.com", "domain":"api2.com" } }
- 字段说明:
- id: 域名 ID, 即为 domain_id
- punycode: 使用 punycode 转码之后的域名
- domain: 添加的域名
获取域名列表¶
- 接口地址：
- HTTP请求方式：
- POST
- 请求参数：
参数名 是否必须 参数描述 公共参数 是 详见：公共参数 type 否 - 域名分组类型, 默认为’all’. 包含以下类型：
- all：所有域名
- mine：我的域名
- share：共享给我的域名
- ismark：星标域名
- pause：暂停域名
- vip：VIP域名
- recent：最近操作过的域名
- share_out：我共享出去的域名
offset 否 记录开始的偏移, 第一条记录为 0, 依次类推 length 否 要获取的域名数量, 比如获取20个, 则为20 group_id 否 分组ID, 获取指定分组的域名。可以通过 获取域名分组 获取 group_id keyword 否 搜索的关键字, 如果指定则只返回符合该关键字的域名 - 注意事项：
- 如果账户中的域名数量超过了3000, 将会强制分页并且只返回前3000条, 这时需要通过 offset 和 length 参数去获取其它域名.
- 响应代码：
- 共通返回
- 6 记录开始的偏移无效
- 7 共要获取的记录的数量无效
- 9 没有任何域名
示例:
curl -X POST https://dnsapi.cn/Domain.List -d 'login_token=LOGIN_TOKEN&format=json'
返回参考：
JSON:
{ "status": { "code": "1", "message": "Action completed successful", "created_at": "2015-01-18 16:21:28" }, "info": { "domain_total": 2, "all_total": 2, "mine_total": 2, "share_total": 0, "vip_total": 0, "ismark_total": 0, "pause_total": 0, "error_total": 2, "lock_total": 0, "spam_total": 0, "vip_expire": 0, "share_out_total": 0 }, "domains": [ { "id": 2238269, "status": "enable", "grade": "D_Free", "group_id": "1", "searchengine_push": "yes", "is_mark": "no", "ttl": "300", "cname_speedup": "disable", "remark": "", "created_on": "2015-01-19 08:20:03", "updated_on": "2015-01-19 18:54:35", "punycode": "xn--vnqp08b.cn", "ext_status": "dnserror", "name": "我们.cn", "grade_title": "免费套餐", "is_vip": "no", "owner": "api@dnspod.com", "records": "4", "auth_to_anquanbao": true }, { "id": 10360095, "status": "enable", "grade": "DP_Free", "group_id": "1", "searchengine_push": "yes", "is_mark": "no", "ttl": "600", "cname_speedup": "disable", "remark": "", "created_on": "2014-11-25 16:56:31", "updated_on": "2015-01-19 16:56:31", "punycode": "usertest.com", "ext_status": "dnserror", "name": "usertest.com", "grade_title": "新免费套餐", "is_vip": "no", "owner": "api@dnspod.com", "records": "2", "auth_to_anquanbao": true } ] }
- 字段说明:
- info:
- domain_total: 域名总数
- all_total: 域名总数
- mine_total: 自己创建的域名总数(不包括共享得到的域名)
- share_total: 共享得到的域名总数
- vip_total: VIP 域名总数
- ismark_total: 星标域名的总数
- pause_total: 暂停解析的域名总数
- error_total: DNS 设置错误的域名总数(包括未注册的和 NS 地址没有改到 DNSPod 的域名)
- lock_total: 已锁定的域名总数
- spam_total: 已被封禁的域名总数
- vip_expire: VIP 即将到期的域名总数(30天之内)
- share_out_total: 共享出去的域名总数
- domains:
id: 域名 ID, 即为 domain_id
- status: 域名状态
- “enable”: 正常
- “pause”: 已暂停解析
- “spam”: 已被封禁
- “lock”: 已被锁定
- grade: 域名等级
- “D_Free”: 旧免费套餐 (旧套餐)
- “D_Plus”: 个人豪华套餐 (旧套餐)
- “D_Extra”: 企业Ⅰ (旧套餐)
- “D_Expert” 企业Ⅱ (旧套餐)
- “D_Ultra”: 企业Ⅲ (旧套餐)
- “DP_Free” 免费套餐
- “DP_Plus”: 个人专业版
- “DP_Extra”: 企业创业版
- “DP_Expert”: 企业标准版
- “DP_Ultra”: 企业旗舰版
group_id: 域名分组 ID
- searchengine_push: 是否开启搜索引擎推送功能
- “yes”: 已开启
- “no”: 未开启
- is_mark: 是否设置域名星标
- “yes”: 已设置
- “no”: 未设置
ttl: 域名默认的 TTL 值
- cname_speedup: CNAME 加速状态
- “enable”: 已启用
- “disable”: 已禁用
remark: 域名备注
created_on: 添加域名的时间
updated_on: 域名最后修改时间
punycode: 使用 punycode 转码之后的域名
- ext_status: 域名扩展的状态
- “notexist”: 域名没有注册
- “dnserror”: DNS 设置错误
- “”: 正常
name: 域名
grade_title: 域名等级(中文说明)
- is_vip: 是否是VIP 等级
- “yes”: 是 VIP
- “no”: 不是 VIP
owner: 域名所有者
records: 域名下记录总条数
auth_to_anquanbao: 是否授权给安全中心(系统内部标识状态, 开发者可忽略)
删除域名¶
- 接口地址：
- HTTP请求方式：
- POST
- 请求参数：
参数名 是否必须 参数描述 公共参数 是 详见：公共参数 domain_id 或 domain 是 分别对应域名ID和域名, 提交其中一个即可 - 响应代码：
- 共通返回
- -15 域名已被封禁
- 6 域名ID错误
- 7 域名已锁定
- 8 VIP域名不可以删除
- 9 非域名所有者
示例:
curl -X POST https://dnsapi.cn/Domain.Remove -d 'login_token=LOGIN_TOKEN&format=json&domain_id=1992403'
返回参考：
JSON:
{ "status": { "code": "1", "message": "Action completed successful", "created_at": "2015-01-18 11:09:31" } }
设置域名状态¶
- 接口地址：
- HTTP请求方式：
- POST
- 请求参数：
参数名 是否必须 参数描述 公共参数 是 详见：公共参数 domain_id 或 domain 是 分别对应域名ID和域名, 提交其中一个即可 status 是 域名状态，”enable” 、”disable” 分别代表启用和暂停 - 响应代码：
- 共通返回
- -15 域名已被封禁
- -7 企业账号的域名需要升级才能设置
- -8 代理名下用户的域名需要升级才能设置
- 6 域名ID错误
- 7 域名被锁定
- 8 非域名所有者
示例:
curl -X POST https://dnsapi.cn/Domain.Status -d 'login_token=LOGIN_TOKEN&format=json&domain_id=2058967&status=disable'
返回参考：
JSON:
{ "status": { "code": "1", "message": "Action completed successful", "created_at": "2015-01-18 12:02:04" } }
获取域名信息¶
- 接口地址：
- HTTP请求方式：
- POST
- 请求参数：
参数名 是否必须 参数描述 公共参数 是 详见：公共参数 domain_id 或 domain 是 分别对应域名ID和域名, 提交其中一个即可 - 响应代码：
- 共通返回
- -7 企业账号的域名需要升级才能设置
- -8 代理名下用户的域名需要升级才能设置
- 6 域名ID错误
- 8 非域名所有者
示例:
curl -X POST https://dnsapi.cn/Domain.Info -d 'login_token=LOGIN_TOKEN&format=json&domain_id=2059079'
返回参考：
JSON:
{ "status": { "code": "1", "message": "Action completed successful", "created_at": "2015-01-18 17:06:40" }, "domain": { "id": "2238269", "name": "我们.cn", "punycode": "xn--vnqp08b.cn", "grade": "D_Free", "grade_title": "免费套餐", "status": "enable", "ext_status": "dnserror", "records": "4", "group_id": "1", "is_mark": "no", "remark": false, "is_vip": "no", "searchengine_push": "yes", "user_id": "625033", "created_on": "2015-01-19 07:23:03", "updated_on": "2015-01-19 18:54:35", "ttl": "300", "cname_speedup": "disable", "owner": "api@dnspod.com", "auth_to_anquanbao": true } }
- 字段说明:
id: 域名 ID, 即为 domain_id
- status: 域名状态
- “enable”: 正常
- “pause”: 已暂停解析
- “spam”: 已被封禁
- “lock”: 已被锁定
- grade: 域名等级
- “D_Free”: 旧免费套餐 (旧套餐)
- “D_Plus”: 个人豪华套餐 (旧套餐)
- “D_Extra”: 企业Ⅰ (旧套餐)
- “D_Expert” 企业Ⅱ (旧套餐)
- “D_Ultra”: 企业Ⅲ (旧套餐)
- “DP_Free” 免费套餐
- “DP_Plus”: 个人专业版
- “DP_Extra”: 企业创业版
- “DP_Expert”: 企业标准版
- “DP_Ultra”: 企业旗舰版
group_id: 域名分组 ID
- searchengine_push: 是否开启搜索引擎推送功能
- “yes”: 已开启
- “no”: 未开启
- is_mark: 是否设置域名星标
- “yes”: 已设置
- “no”: 未设置
ttl: 域名默认的 TTL 值
- cname_speedup: CNAME 加速状态
- “enable”: 已启用
- “disable”: 已禁用
remark: 域名备注
created_on: 添加域名的时间
updated_on: 域名最后修改时间
punycode: 使用 punycode 转码之后的域名
- ext_status: 域名扩展的状态
- “notexist”: 域名没有注册
- “dnserror”: DNS 设置错误
- “”: 正常
name: 域名
grade_title: 域名等级(中文说明)
- is_vip: 是否是VIP 等级
- “yes”: 是 VIP
- “no”: 不是 VIP
owner: 域名所有者
records: 域名下记录总条数
auth_to_anquanbao: 是否授权给安全中心(系统内部标识状态, 开发者可忽略)
获取域名日志¶
- 接口地址：
- HTTP请求方式：
- POST
- 请求参数：
参数名 是否必须 参数描述 公共参数 是 详见：公共参数 domain_id 或 domain 是 分别对应域名ID和域名, 提交其中一个即可 offset 否 记录开始的偏移，第一条记录为 0，依次类推，默认为0 length 否 共要获取的日志条数，比如获取20条，则为20，默认为500条，单次最多获取500条 - 响应代码：
- 共通返回
- -7 企业账号的域名需要升级才能设置
- -8 代理名下用户的域名需要升级才能设置
- 6 域名ID错误
- 8 非域名所有者
示例:
curl -X POST https://dnsapi.cn/Domain.Log -d 'login_token=LOGIN_TOKEN&format=json&domain_id=2059079'
返回参考：
JSON:
{ "status": { "code": "1", "message": "Action completed successful", "created_at": "2015-01-18 17:24:23" }, "log": [ "2015-01-18 12:07:05: (111.111.111.111) 启用解析 NS 记录 默认 线路 @ 值 f1g1ns1.dnspod.net.", "2015-01-18 12:07:04: (111.111.111.111) 启用解析 NS 记录 默认 线路 @ 值 f1g1ns2.dnspod.net. ", "2015-01-18 12:07:02: (111.111.111.111) 暂停解析 NS 记录 默认 线路 @ 值 f1g1ns2.dnspod.net. ", "2015-01-18 12:06:57: (111.111.111.111) 暂停解析 NS 记录 默认 线路 @ 值 f1g1ns1.dnspod.net. ", "2015-01-18 12:06:33(API): (111.111.111.111) 暂停 域名解析", "2015-01-18 12:06:12: (111.111.111.111) 添加 CNAME 记录 默认 线路 pop 值 mail.api4.com. ", "2015-01-18 12:06:12: (111.111.111.111) 添加 A 记录 默认 线路 shop 值 64.144.7.55 ", "2015-01-18 12:06:12: (111.111.111.111) 添加 CNAME 记录 默认 线路 smtp 值 mail.api4.com. ", "2015-01-18 12:06:11: (111.111.111.111) 添加 A 记录 默认 线路 ftp 值 64.144.7.51 ", "2015-01-18 12:06:11: (111.111.111.111) 添加 CNAME 记录 默认 线路 e 值 email.secureserver.net. ", "2015-01-18 12:05:46: (111.111.111.111) 添加新域名 api4.com api@dnspod.com(625033)" ] }
设置搜索引擎推送¶
- 接口地址：
- HTTP请求方式：
- POST
- 请求参数：
参数名 是否必须 参数描述 公共参数 是 详见：公共参数 domain_id 或 domain 是 分别对应域名ID和域名, 提交其中一个即可 status 是 是否推送，”yes”、”no” 分别代表开启和关闭 - 响应代码：
- 共通返回
- -15 域名已被封禁
- -7 企业账号的域名需要升级才能设置
- -8 代理名下用户的域名需要升级才能设置
- 6 域名ID错误
- 7 域名被锁定
- 8 非域名所有者
示例:
curl -X POST https://dnsapi.cn/Domain.Searchenginepush -d 'login_token=LOGIN_TOKEN&format=json&domain_id=2059079&status=yes'
返回参考：
JSON:
{ "status": { "code": "1", "message": "Action completed successful", "created_at": "2015-01-18 17:28:44" } }
域名过户¶
- 接口地址：
- HTTP请求方式：
- POST
- 请求参数：
参数名 是否必须 参数描述 公共参数 是 详见：公共参数 domain_id 或 domain 是 分别对应域名ID和域名, 提交其中一个即可 email 是 域名将要过户到的邮箱帐号 - 响应代码：
- 共通返回
- -15 域名已被封禁
- -7 企业账号的域名需要升级才能设置
- -8 代理名下用户的域名需要升级才能设置
- 6 域名ID错误
- 7 要过户到的账号邮箱错误
- 8 要过户到的账号邮箱不存在
- 9 不能过户给自己
- 10 个人用户域名不能过户给企业账号
- 11 企业用户域名不能过户给个人账号
示例:
curl -X POST https://dnsapi.cn/Domainshare.Transfer -d 'login_token=LOGIN_TOKEN&format=json&domain_id=2059079&email=yizerowu@dnspod.com'
返回参考：
JSON:
{ "status": { "code": "1", "message": "Action completed successful", "created_at": "2015-01-18 20:21:33" } }
锁定域名¶
- 接口地址：
- HTTP请求方式：
- POST
- 请求参数：
参数名 是否必须 参数描述 公共参数 是 详见：公共参数 domain_id 或 domain 是 分别对应域名ID和域名, 提交其中一个即可 days 是 域名要锁定的天数，最多可锁定的天数可以通过 获取域名权限 接口获取 - 响应代码：
- 共通返回
- -15 域名已被封禁
- -7 企业账号的域名需要升级才能设置
- -8 代理名下用户的域名需要升级才能设置
- 6 域名ID错误
- 7 不是域名所有者或者没有权限
- 8 锁定天数错误
- 9 锁定天数超出限制
- 21 域名已经被锁定
示例:
curl -X POST https://dnsapi.cn/Domain.Lock -d 'login_token=LOGIN_TOKEN&format=json&domain_id=2059079&days=3'
返回参考：
JSON:
{ "status": { "code": "1", "message": "Action completed successful", "created_at": "2015-01-18 20:31:13" }, "lock": { "domain_id": 2059079, "lock_code": "fdd638", "lock_end": "2015-01-21" } }
- 字段说明:
- domain_id: 域名ID, 即为 domain_id
- lock_code: 域名解锁码
- lock_end: 域名自动解锁日期
域名锁定解锁¶
- 接口地址：
- HTTP请求方式：
- POST
- 请求参数：
参数名 是否必须 参数描述 公共参数 是 详见：公共参数 domain_id 或 domain 是 分别对应域名ID和域名, 提交其中一个即可 lock_code 是 域名解锁码, 锁定的时候会返回 - 响应代码：
- 共通返回
- -15 域名已被封禁
- -7 企业账号的域名需要升级才能设置
- -8 代理名下用户的域名需要升级才能设置
- 6 域名ID错误
- 7 不是域名所有者或者没有权限
- 8 域名没有锁定
- 9 解锁码错误
示例:
curl -X POST https://dnsapi.cn/Domain.Unlock -d 'login_token=LOGIN_TOKEN&format=json&domain_id=2059079&lock_code=fdd638'
返回参考：
JSON:
{ "status": { "code": "1", "message": "Action completed successful", "created_at": "2015-01-18 20:21:33" } }
域名绑定列表¶
- 接口地址：
- HTTP请求方式：
- POST
- 请求参数：
参数名 是否必须 参数描述 公共参数 是 详见：公共参数 domain_id 或 domain 是 分别对应域名ID和域名, 提交其中一个即可 - 响应代码：
- 共通返回
- -7 企业账号的域名需要升级才能设置
- -8 代理名下用户的域名需要升级才能设置
- 6 域名ID错误
- 7 没有绑定记录
示例:
curl -X POST https://dnsapi.cn/Domainalias.List -d 'login_token=LOGIN_TOKEN&format=json&domain_id=2059079'
返回参考：
JSON:
{ "status": { "code": "1", "message": "Action completed successful", "created_at": "2015-01-18 21:11:20" }, "alias": [ { "id": "18737", "domain": "dnspodapi.com" } ] }
- 字段说明:
- id: 域名别名绑定的ID
- domain: 绑定的域名
添加域名绑定¶
- 接口地址：
- HTTP请求方式：
- POST
- 请求参数：
参数名 是否必须 参数描述 公共参数 是 详见：公共参数 domain_id 是 要创建别名绑定的域名ID domain 是 要绑定到的域名，不带 www，例如：dnspod.com - 响应代码：
- 共通返回
- -15 域名已被封禁
- -7 企业账号的域名需要升级才能设置
- -8 代理名下用户的域名需要升级才能设置
- 6 域名ID错误
- 7 要绑定的域名错误
- 8 要绑定的域名已经被添加
- 9 要绑定的域名已经被绑定
- 10 绑定数量已经到达上限
示例:
curl -X POST https://dnsapi.cn/Domainalias.Create -d 'login_token=LOGIN_TOKEN&format=json&domain_id=2059079&domain=dnspodapi.com'
返回参考：
JSON:
{ "status": { "code": "1", "message": "Action completed successful", "created_at": "2015-01-18 21:09:57" }, "alias": { "id": "18737", "punycode": "dnspodapi.com" } }
- 字段说明:
- id: 域名别名绑定的 ID
- punycode: 别名绑定的域名
删除域名绑定¶
- 接口地址：
- HTTP请求方式：
- POST
- 请求参数：
参数名 是否必须 参数描述 公共参数 是 详见：公共参数 domain_id 或 domain 是 分别对应域名ID和域名, 提交其中一个即可 alias_id 是 别名绑定的ID, 绑定域名的时候会返回 - 响应代码：
- 共通返回
- -15 域名已被封禁
- -7 企业账号的域名需要升级才能设置
- -8 代理名下用户的域名需要升级才能设置
- 6 域名ID错误
- 7 绑定ID错误
示例:
curl -X POST https://dnsapi.cn/Domainalias.Remove -d 'login_token=LOGIN_TOKEN&format=json&domain_id=2059079&alias_id=18737'
返回参考：
JSON:
{ "status": { "code": "1", "message": "Action completed successful", "created_at": "2015-01-18 21:15:20" } }
获取域名分组¶
- 接口地址：
- HTTP请求方式：
- POST
- 请求参数：
参数名 是否必须 参数描述 公共参数 是 详见：公共参数 - 响应代码：
- 共通返回
示例:
curl -X POST https://dnsapi.cn/Domaingroup.List -d 'login_token=LOGIN_TOKEN&format=json'
返回参考：
JSON:
{ "status": { "code": "1", "message": "Action completed successful", "created_at": "2015-01-18 17:44:54" }, "groups": [ { "group_id": 1, "group_name": "默认分组", "group_type": "system", "size": 2 }, { "group_id": 2, "group_name": "经常修改", "group_type": "system", "size": 0 }, { "group_id": 3, "group_name": "很少修改", "group_type": "system", "size": 0 }, { "group_id": 4, "group_name": "即将到期", "group_type": "system", "size": 0 }, { "group_id": 5, "group_name": "私人域名", "group_type": "system", "size": 0 }, { "group_id": 6, "group_name": "公司域名", "group_type": "system", "size": 0 }, { "group_id": 7, "group_name": "客户域名", "group_type": "system", "size": 0 }, { "group_id": 8, "group_name": "与我共享", "group_type": "system", "size": 0 } ] }
添加域名分组¶
- 接口地址：
- https://dnsapi.cn/Domaingroup.Create
- HTTP请求方式：
- POST
- 请求参数：
参数名 是否必须 参数描述 公共参数 是 详见：公共参数 group_name 是 分组名称 - 响应代码：
- 共通返回
- 7 分组名称错误
- 8 分组名称已经存在
- 9 分组数量超出限制
示例:
curl -X POST https://dnsapi.cn/Domaingroup.List -d 'login_token=LOGIN_TOKEN&format=json&group_name=dnspod'
返回参考：
JSON:
{ "status": { "code": "1", "message": "Action completed successful", "created_at": "2015-01-18 21:41:00" }, "groups": { "id": "1985" } }
- 字段说明:
id: 域名分组的 ID
- 说明：
- 该接口只对VIP帐户有效, 免费用户无法获取域名分组, 免费用户会返回错误提示.
修改域名分组¶
- 接口地址：
- https://dnsapi.cn/Domaingroup.Modify
- HTTP请求方式：
- POST
- 请求参数：
参数名 是否必须 参数描述 公共参数 是 详见：公共参数 group_id 是 要修改的分组ID group_name 是 需要修改到的分组名称 - 响应代码：
- 共通返回
- 6 分组ID错误
- 7 分组名称错误
- 8 分组名称已经存在
- 9 分组数量超出限制
示例:
curl -X POST https://dnsapi.cn/Domaingroup.Modify -d 'login_token=LOGIN_TOKEN&format=json&group_id=1985&group_name=dnspodgroup'
返回参考：
JSON:
{ "status": { "code": "1", "message": "Action completed successful", "created_at": "2015-01-18 10:25:32" } }
删除域名分组¶
- 接口地址：
- HTTP请求方式：
- POST
- 请求参数：
参数名 是否必须 参数描述 公共参数 是 详见：公共参数 group_id 是 要删除的分组ID - 响应代码：
- 共通返回
- 6 分组ID错误
示例:
curl -X POST https://dnsapi.cn/Domaingroup.Remove -d 'login_token=LOGIN_TOKEN&format=json&group_id=1985'
返回参考：
JSON:
{ "status": { "code": "1", "message": "Action completed successful", "created_at": "2015-01-18 10:45:45" } }
设置域名分组¶
- 接口地址：
- HTTP请求方式：
- POST
- 请求参数：
参数名 是否必须 参数描述 公共参数 是 详见：公共参数 domain_id 或 domain 是 分别对应域名ID和域名, 提交其中一个即可 group_id 是 分组ID - 响应代码：
- 共通返回
- 6 域名ID错误
- 7 分组ID错误
示例:
curl -X POST https://dnsapi.cn/Domain.Changegroup -d 'login_token=LOGIN_TOKEN&format=json&domain_id=2059079&group_id=1985'
返回参考：
JSON:
{ "status": { "code": "1", "message": "Action completed successful", "created_at": "2015-01-18 17:33:01" } }
说明：
- 其它用户共享过来的域名全在“与我共享”系统分组下, 不能更改
- 只有域名所有者可以更改域名的分组, 被共享者不能更改
设置域名星标¶
- 接口地址：
- HTTP请求方式：
- POST
- 请求参数：
参数名 是否必须 参数描述 公共参数 是 详见：公共参数 domain_id 或 domain 是 分别对应域名ID和域名, 提交其中一个即可 is_mark 是 是否星标域名，”yes”、”no” 分别代表是和否 - 响应代码：
- 共通返回
- 6 域名ID错误
示例:
curl -X POST https://dnsapi.cn/Domain.Ismark -d 'login_token=LOGIN_TOKEN&format=json&domain_id=2059079&is_mark=yes'
返回参考：
JSON:
{ "status": { "code": "1", "message": "Action completed successful", "created_at": "2015-01-18 17:42:02" } }
设置域名备注¶
- 接口地址：
- HTTP请求方式：
- POST
- 请求参数：
参数名 是否必须 参数描述 公共参数 是 详见：公共参数 domain_id 或 domain 是 分别对应域名ID和域名, 提交其中一个即可 remark 是 域名备注, 删除备注请提交空内容 - 响应代码：
- 共通返回
- 6 域名ID错误
示例:
curl -X POST https://dnsapi.cn/Domain.Remark -d 'login_token=LOGIN_TOKEN&format=json&domain_id=2059079&remark=这个域名需要备注一下'
返回参考：
JSON:
{ "status": { "code": "1", "message": "Action completed successful", "created_at": "2015-01-18 17:50:37" } }
获取域名权限¶
- 接口地址：
- HTTP请求方式：
- POST
- 请求参数：
参数名 是否必须 参数描述 公共参数 是 详见：公共参数 domain_id 或 domain 是 分别对应域名ID和域名, 提交其中一个即可 - 响应代码：
- 共通返回
- 6 域名ID不正确
示例:
curl -X POST https://dnsapi.cn/Domain.Purview -d 'login_token=LOGIN_TOKEN&format=json&domain_id=2059079'
返回参考：
JSON:
{ "status": { "code": "1", "message": "Action completed successful", "created_at": "2015-01-18 17:51:25" }, "purview": [ { "name": "URL转发条数", "value": 10 }, { "name": "NS记录条数", "value": 99999 }, { "name": "AAAA记录条数", "value": 99999 }, { "name": "SRV记录条数", "value": 10 }, { "name": "域名别名绑定个数", "value": 3 }, { "name": "域名锁定天数", "value": 30 }, { "name": "域名共享个数", "value": 2 }, { "name": "子域名级数", "value": 3 }, { "name": "泛解析级数", "value": 2 }, { "name": "负载均衡数量", "value": 4 }, { "name": "记录TTL最低", "value": 120 }, { "name": "混合泛解析支持", "value": "no" }, { "name": "增强线路类型", "value": "yes" }, { "name": "分省线路类型", "value": "no" }, { "name": "分大洲线路类型", "value": "no" } ] }
- 说明：
- 获取成功后要在本地保存一份, 不要操作一次获取一次
域名取回获取 WHOIS 邮箱列表¶
- 接口地址：
- HTTP请求方式：
- POST
- 请求参数：
参数名 是否必须 参数描述 公共参数 是 详见：公共参数 domain 是 要取回的域名 - 响应代码：
- 共通返回
- 6 域名不正确
- 7 不支持中文域名
- 8 域名不正确
- 9 不支持免费.tk域名
- 10 域名不存在
- 11 域名已被封禁, 不能取回
- 12 锁定的域名不能取回
- 13 个人用户不能取回企业用户域名
- 14 企业用户不能取回个人用户域名
- 15 获取不到邮箱, 可能是网络错误或域名不支持
- 86 不能取回 VIP 域名
示例:
curl -X POST https://dnsapi.cn/Domain.Acquire -d 'login_token=LOGIN_TOKEN&format=json&domain=api4.com'
返回参考：
JSON:
{ "status": { "code": "1", "message": "Action completed successful", "created_at": "2015-01-18 18:00:05" }, "emails": [ "support@namecheap.com", "e31d739cb2824a5f80d7b90848a195d8.protect@whoisguard.com" ] }
- 字段说明:
emails: 域名 WHOIS 的邮箱, 可能存在多个
域名取回发送验证码¶
- 接口地址：
- HTTP请求方式：
- POST
- 请求参数：
参数名 是否必须 参数描述 公共参数 是 详见：公共参数 domain 是 要取回的域名 email 是 域名取回WHOIS邮箱列表中的一个邮箱，验证码会发送到该邮箱 - 响应代码：
- 共通返回
- 6 域名不正确
- 7 不支持中文域名
- 8 域名不正确
- 9 不支持免费.tk域名
- 10 域名不存在
- 11 域名已被封禁, 不能取回
- 12 锁定的域名不能取回
- 13 个人用户不能取回企业用户域名
- 14 企业用户不能取回个人用户域名
- 15 获取不到邮箱, 可能是网络错误或域名不支持
- 16 邮箱参数错误
示例:
curl -X POST https://dnsapi.cn/Domain.Acquiresend -d 'login_token=LOGIN_TOKEN&format=json&domain=api4.com&email=support@namecheap.com'
- 返回参考：
JSON:
{ "status": { "code": "1", "message": "Action completed successful", "created_at": "2015-01-18 18:07:44" } }
验证域名取回的验证码¶
- 接口地址：
- HTTP请求方式：
- POST
- 请求参数：
参数名 是否必须 参数描述 公共参数 是 详见：公共参数 domain 是 要取回的域名 code 是 发送到邮箱的验证码 - 响应代码：
- 共通返回
- 6 域名不正确
- 7 不支持中文域名
- 8 域名不正确
- 9 不支持免费.tk域名
- 10 域名不存在
- 11 域名已被封禁, 不能取回
- 12 锁定的域名不能取回
- 13 个人用户不能取回企业用户域名
- 14 企业用户不能取回个人用户域名
- 15 验证码不正确
- 16 邮箱参数错误
示例:
curl -X POST https://dnsapi.cn/Domain.Acquirevalidate -d 'login_token=LOGIN_TOKEN&format=json&domain=api4.com&code=111000'
返回参考：
JSON:
{ "status": { "code": "1", "message": "Action completed successful", "created_at": "2015-01-18 18:12:44" } }
域名取回发送验证链接¶
- 接口地址：
- HTTP请求方式：
- POST
- 请求参数：
参数名 是否必须 参数描述 公共参数 是 详见：公共参数 domain 是 要取回的域名 whois_email 是 域名取回WHOIS邮箱列表中的一个邮箱，验证链接会发送到该邮箱 - 响应代码：
- 共通返回
- 6 域名不正确
- 7 不支持中文域名
- 8 域名不正确
- 9 不支持免费.tk域名
- 10 域名不存在
- 11 域名已被封禁, 不能取回
- 12 锁定的域名不能取回
- 13 个人用户不能取回企业用户域名
- 14 企业用户不能取回个人用户域名
- 15 获取不到邮箱, 可能是网络错误或域名不支持
- 16 邮箱参数错误
示例:
curl -X POST https://dnsapi.cn/Domain.Acquiresend.New -d 'login_token=LOGIN_TOKEN&format=json&domain=api4.com&whois_email=support@namecheap.com'
- 返回参考：
JSON:
{ "status": { "code": "1", "message": "Action completed successful", "created_at": "2016-03-04 16:07:44" } }
- 说明：
- 该接口是直接将验证链接发送至域名的 WHOIS 邮箱，用户点击链接进行确认，认证通过后，完成域名取回。
获取等级允许的记录类型¶
- 接口地址：
- HTTP请求方式：
- POST
- 请求参数：
参数名 是否必须 参数描述 公共参数 是 详见：公共参数 domain_grade 是 - 域名等级, 分别为：
- 旧套餐：D_Free、D_Plus、D_Extra、D_Expert、D_Ultra 分别对应免费套餐、个人豪华、企业1、企业2、企业3
- 新套餐：DP_Free、DP_Plus、DP_Extra、DP_Expert、DP_Ultra 分别对应新免费、个人专业版、企业创业版、企业标准版、企业旗舰版
- 响应代码：
- 共通返回
- 6 等级代码不正确
示例:
curl -X POST https://dnsapi.cn/Record.Type -d 'login_token=LOGIN_TOKEN&format=json&domain_grade=D_Free'
返回参考：
JSON:
{ "status": { "code": "1", "message": "Action completed successful", "created_at": "2015-01-18 18:23:40" }, "types": [ "A", "CNAME", "MX", "TXT", "NS", "AAAA", "SRV", "URL" ] }
- 说明：
- 如果域名等级没有变更，则每次返回的允许的记录类型都是一致的，建议获取成功后在本地保存一份, 不要用一次就请求一次
获取等级允许的线路¶
- 接口地址：
- HTTP请求方式：
- POST
- 请求参数：
参数名 是否必须 参数描述 公共参数 是 详见：公共参数 domain_id 或 domain 是 分别对应域名ID和域名, 提交其中一个即可 domain_grade 是 - 域名等级, 分别为：
- 旧套餐：D_Free、D_Plus、D_Extra、D_Expert、D_Ultra 分别对应免费套餐、个人豪华、企业1、企业2、企业3
- 新套餐：DP_Free、DP_Plus、DP_Extra、DP_Expert、DP_Ultra 分别对应新免费、个人专业版、企业创业版、企业标准版、企业旗舰版
- 响应代码：
- 共通返回
- 6 等级代码不正确
示例:
curl -X POST https://dnsapi.cn/Record.Line -d 'login_token=LOGIN_TOKEN&format=json&domain_grade=D_Free&domain_id=2059079'
返回参考：
JSON:
{ "status": { "code": "1", "message": "Action completed successful", "created_at": "2016-08-12 17:08:56" }, "line_ids": { "默认": 0, "国内": "7=0", "国外": "3=0", "电信": "10=0", "联通": "10=1", "教育网": "10=2", "移动": "10=3", "百度": "90=0", "谷歌": "90=1", "搜搜": "90=4", "有道": "90=2", "必应": "90=3", "搜狗": "90=5", "奇虎": "90=6", "搜索引擎": "80=0" }, "lines": [ "默认", "国内", "国外", "电信", "联通", "教育网", "移动", "百度", "谷歌", "搜搜", "有道", "必应", "搜狗", "奇虎", "搜索引擎" ] }
- 说明：
- 如果域名等级没有变更，则每次返回的允许的线路都是一致的，建议获取成功后在本地保存一份, 不要用一次就请求一次
- line_ids 为新增的返回字段，对应关系为: 中文线路名称：线路ID，支持在创建、修改解析记录的时候传入线路ID，解决之前部分开发者存在的中文编码问题
