域名区域列表

GET/v2/dns/zones

列出账户托管的 DNS 区域及其解析状态。

Bearer Token dns:read api.demo.acme-cloud.dev

请求参数

共 4 项

page 可选查询

integer · 默认 1

页码，从 1 开始

page_size 可选查询

integer · 默认 20

每页条数，1–100

sort 可选查询

string

排序字段，前缀 - 表示降序

keyword 可选查询

string

按域名模糊搜索

响应

2 种状态

200 OK

响应示例

{
  "total": 3,
  "items": [
    {
      "id": "zone_2f91",
      "name": "acme-cloud.com",
      "record_count": 48,
      "status": "active",
      "nameservers": [
        "ns1.acme-dns.dev",
        "ns2.acme-dns.dev"
      ],
      "created_at": "2025-10-02T01:00:00Z"
    },
    {
      "id": "zone_4c07",
      "name": "aihao.team",
      "record_count": 21,
      "status": "active",
      "nameservers": [
        "ns1.acme-dns.dev",
        "ns2.acme-dns.dev"
      ],
      "created_at": "2026-03-14T05:40:00Z"
    }
  ]
}

代码示例

cURL

curl -i -X GET 'https://api.demo.acme-cloud.dev/v2/dns/zones?page=1&page_size=20&sort=-created_at' \
  -H 'Accept: application/json'