获取域名信息
注意:本页面提供 API 文档为 DNSPod 传统 API ,仅支持 DNSPod Token。仅限主账号调用,子账号不可用。 推荐使用 腾讯云 API 3.0 ,支持 CAM 权限管理,同时支持主账号、子账号调用。兼容腾讯云 API 密钥,提供 API Explorer、API 调用统计等工具,还可以与腾讯云其他产品更好协同使用。
1. 接口描述
本接口 Domain.Info 用于获取域名信息。
接口请求地址:https://dnsapi.cn/Domain.Info
HTTP请求方式:POST
2. 请求参数
以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,见 公共请求参数 页面。
参数名 | 是否必须 | 类型 | 参数描述 |
---|---|---|---|
domain_id 或 domain | 是 | Integer 或 String | 分别对应域名ID和域名, 提交其中一个即可。 |
3. 响应代码
以下请求参数列表仅列出了此接口请求响应代码,除此接口请求响应代码外。还包含 共通返回。
响应码 | 描述 |
---|---|
6 | 域名 ID 错误。 |
7 | 非域名所有者。 |
8 | 非域名所有者。 |
13 | 当前域名有误,请返回重新操作。 |
4. 示例
curl -X POST https://dnsapi.cn/Domain.Info -d 'login_token=LOGIN_TOKEN&format=json&domain_id=12600793'
返回示例如下:
- JSON:
{
"status": {
"code": "1",
"message": "Action completed successful",
"created_at": "2018-06-15 16:08:06"
},
"domain": {
"id": "12600793",
"name": "example.com",
"punycode": "example.com",
"grade": "DP_Plus",
"grade_title": "个人专业版",
"status": "enable",
"ext_status": "dnserror",
"records": "5",
"group_id": "1",
"is_mark": "no",
"remark": false,
"is_vip": "yes",
"searchengine_push": "no",
"user_id": "901551",
"created_on": "2018-06-05 19:44:33",
"updated_on": "2018-06-05 19:44:33",
"ttl": "300",
"cname_speedup": "disable",
"owner": "api@dnspod.com",
"vip_start_at": "2018-06-15",
"vip_end_at": "2019-06-14",
"vip_auto_renew": "no",
"dnspod_ns": [
"ns3.dnsv3.com" ,
"ns4.dnsv3.com"
],
"is_beian": "yes"
}
}
-
字段说明:
-
id: 域名 ID, 即为 domain_id。
-
name: 域名。
-
punycode: 使用 punycode 转码之后的域名。
-
grade: 域名等级:
- “D_Free”: 旧免费套餐 (旧套餐)。
- “D_Plus”: 个人豪华套餐 (旧套餐)。
- “D_Extra”: 企业Ⅰ (旧套餐)。
- “D_Expert” 企业Ⅱ (旧套餐)。
- “D_Ultra”: 企业Ⅲ (旧套餐)。
- “DP_Free” 免费套餐。
- “DP_Plus”: 个人专业版。
- “DP_Extra”: 企业创业版。
- “DP_Expert”: 企业标准版。
- “DP_Ultra”: 企业旗舰版。
-
grade_title: 域名等级(中文说明)。
-
status: 域名状态:
- “enable”: 正常。
- “pause”: 已暂停解析。
- “spam”: 已被封禁。
- “lock”: 已被锁定。
-
ext_status: 域名扩展的状态:
- “notexist”: 域名没有注册。
- “dnserror”: DNS 设置错误。
- “”: 正常。
-
records: 域名下记录总条数。
-
group_id: 域名分组 ID。
-
searchengine_push: 是否开启搜索引擎推送功能:
- “yes”: 已开启。
- “no”: 未开启。
-
is_mark: 是否设置域名星标:
- “yes”: 已设置。
- “no”: 未设置。
remark: 域名备注。
-
is_vip:是否是VIP 等级:
- “yes”:是 VIP。
- “no”:不是 VIP。
-
created_on: 添加域名的时间。
-
updated_on: 域名最后修改时间。
-
ttl: 域名默认的 TTL 值。
-
cname_speedup: CNAME 加速状态:
- “enable”: 已启用。
- “disable”: 已禁用。
- owner: 域名所有者。
-
vip_start_at: 解析套餐的开始时间,格式为 yyyy-mm-dd(该字段仅当 is_vip 为“yes”时才存在)。
-
vip_end_at: 解析套餐的到期时间,格式为 yyyy-mm-dd(该字段仅当 is_vip 为“yes”时才存在)。
-
vip_auto_renew: 解析套餐是否会自动续费(该字段仅当 is_vip 为“yes”时才存在):
- yes:解析套餐已设置自动续费。
- no:解析套餐未设置自动续费。
- default:默认状态,未设置自动续费,即初始状态手动续费。(说明:若已开通预付费不停服特权也会进行自动续费)。
-
dnspod_ns: 域名等级对应的ns服务器地址。
-
is_beian: 域名是否有备案。
DNSPod 域名检测工具
查询域名信息,快速排查网站问题
网站自助排障
快速判断问题、提供合适的解决方案