API 文档
文档目录
    加载中
文档中心 API 文档 获取域名信息

获取域名信息

注意:本页面提供 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: 域名是否有备案。

最近更新于 2022-02-14 11:50

DNSPod 域名检测工具

查询域名信息,快速排查网站问题

网站自助排障

快速判断问题、提供合适的解决方案