获取域名列表（二）

注意：本页面提供 API 文档为 DNSPod 传统 API ，仅支持 DNSPod Token。仅限主账号调用，子账号不可用。 推荐使用 腾讯云 API 3.0 ，支持 CAM 权限管理，同时支持主账号、子账号调用。兼容腾讯云 API 密钥，提供 API Explorer、API 调用统计等工具，还可以与腾讯云其他产品更好协同使用。

1. 接口描述

本接口 Domain.List.Filter 用于获取域名列表。
接口请求地址：https://dnsapi.cn/Domain.List.Filter
HTTP请求方式：POST

2. 请求参数

以下请求参数列表仅列出了接口请求参数，正式调用时需要加上公共请求参数，见 公共请求参数 页面。

域名类型, 包含以下类型：

• mine：我的域名。
• share：共享给我的域名。
• recent：最近操作过的域名。

域名状态类型:

• enable：正常
• lock：锁定
• pause：暂停
• spam：封禁

排序字段:

*name：域名名称
*status：域名状态
*records：域名记录数量
*grade：域名套餐
*updated_on：域名更新时间

注意：
如果账户中的域名数量超过了3000, 将会强制分页并且只返回前3000条, 这时需要通过 offset 和 length 参数去获取其它域名。

3. 响应代码
   以下参数列表仅列出了此接口响应代码，除此接口请求响应代码外。还包含 共通返回。

4. 示例

curl -X POST https://dnsapi.cn/Domain.List.Filter -d 'type=mine&login_token=LOGIN_TOKEN&format=json&status[]=enable&status[]=pause'

返回示例如下：

• 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": "免费套餐",
            "grade_ns": [ 
                "ns3.dnsv3.com" ,
                "ns4.dnsv3.com" 
            ],
            "is_vip": "no",
            "owner": "api@dnspod.com",
            "records": "4",
            "vip_start_at": "2019-07-17 00:00:00",
            "vip_end_at": "2020-08-26 23:59:59",
            "vip_auto_renew": "default",
        },
        {
            "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": "新免费套餐",
            "grade_ns": [ 
                "f1g1ns1.dnspod.net" ,
                "f1g1ns2.dnspod.net" 
            ],
            "is_vip": "no",
            "owner": "api@dnspod.com",
            "records": "2",
            "auth_to_anquanbao": true
        }
    ]
}

• 字段说明:

• info:

  • all_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”: 企业旗舰版。
  • grade_ns: 域名等级对应的ns服务器地址。
  • 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: 域名下记录总条数。
  • is_grace_period: 是否在宽限期。
    • "yes”: 在宽限期。
    • "no”: 不在宽限期。