---
title: "API·获取解析记录列表"
description: "POST /api/v1/dns/record/list 接口，获取指定域名下 DNS 解析记录列表，支持按 record/value/type/state/remark 多维度筛选与分页返回。"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.bt.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# API·获取解析记录列表

## 获取解析记录列表

## 接口描述

获取指定域名下的 DNS 解析记录列表，支持分页、筛选和排序。

**接口地址：** `POST /api/v1/dns/record/list`

## 输入参数

### 请求示例

```json
{
  "domain_id": 335,
  "searchKey": "record",
  "searchValue": "www",
  "domain_type": 1,
  "p": 1
}
```

### 请求参数

| 参数名称 | 必选 | 类型 | 描述 |
|---------|------|------|------|
| domain_id | 是 | Integer | 域名 ID |
| searchKey | 否 | String | 搜索关键字字段：record、value、type、state、remark |
| searchValue | 否 | String | 搜索值 |
| domain_type | 是 | Integer | 域名类型：1（宝塔内部域名）、2（外部域名） |
| p | 否 | Integer | 页码，从 1 开始，默认为 1 |

### 筛选参数说明

**搜索关键字字段 (searchKey)：**
- record：按记录名称搜索
- value：按记录值搜索
- type：按记录类型搜索
- state：按记录状态搜索
- remark：按备注信息搜索

**搜索值 (searchValue)：**
- 配合 searchKey 使用，指定具体的搜索内容
- 支持模糊搜索

**域名类型 (domain_type)：**
- 1：宝塔内部域名
- 2：外部域名

## 输出参数

### 响应示例

**成功响应：**

```json
{
  "code": 0,
  "data": {
    "count": 2,
    "data": [
      {
        "MX": 1,
        "TTL": 600,
        "created_at": "Thu, 18 Sep 2025 15:13:52 GMT",
        "domainID": 196311160,
        "domain_id": 75,
        "domain_type": 1,
        "record": "www",
        "recordID": 610347283,
        "record_id": 80,
        "remark": "1111",
        "state": 0,
        "type": "A",
        "uid": 1112,
        "value": "192.168.1.1",
        "viewID": 0
      },
      {
        "MX": 1,
        "TTL": 600,
        "created_at": "Thu, 18 Sep 2025 15:09:22 GMT",
        "domainID": 196311160,
        "domain_id": 75,
        "domain_type": 1,
        "record": "@",
        "recordID": 610347216,
        "record_id": 79,
        "remark": "默认解析",
        "state": 0,
        "type": "A",
        "uid": 1112,
        "value": "192.168.1.1",
        "viewID": 0
      }
    ],
    "page": "<div><span class='Pcurrent'>1</span><span class='Pcount'>共2条数据</span></div>",
    "row": "20",
    "shift": "0"
  },
  "msg": "获取解析记录列表成功",
  "status": true
}
```

**错误响应：**

```json
{
  "code": 404,
  "msg": "域名不存在",
  "status": false
}
```

### 响应参数

| 参数名称 | 类型 | 描述 |
|---------|------|------|
| code | Integer | 状态码，0 表示成功 |
| status | Boolean | 请求是否成功 |
| msg | String | 返回消息 |
| data | Object | 返回数据 |

**data 字段说明：**

| 参数名称 | 类型 | 描述 |
|---------|------|------|
| count | Integer | 记录总数 |
| data | Array | 记录列表 |
| page | String | 分页HTML信息 |
| row | String | 每页数量 |
| shift | String | 偏移量 |

**data 数组中每个记录对象的字段：**

| 参数名称 | 类型 | 描述 |
|---------|------|------|
| MX | Integer | 权重值 |
| TTL | Integer | 生存时间（秒） |
| created_at | String | 创建时间 |
| domainID | Integer | 外部域名系统ID |
| domain_id | Integer | 域名 ID |
| domain_type | Integer | 域名类型：1（宝塔内部域名）、2（外部域名） |
| record | String | 主机记录 |
| recordID | Integer | 外部记录系统ID |
| record_id | Integer | 记录 ID |
| remark | String | 备注信息 |
| state | Integer | 记录状态：0（正常）、1（暂停） |
| type | String | 记录类型 |
| uid | Integer | 用户 ID |
| value | String | 记录值 |
| viewID | Integer | 线路类型 ID |

Source: https://docs.bt.cn/domain/api/dns-records/list-records/index.mdx