获取解析记录列表
接口描述
获取指定域名下的 DNS 解析记录列表，支持分页、筛选和排序。
接口地址： POST /api/v1/dns/record/list
输入参数
请求示例
{
"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：外部域名
输出参数
响应示例
成功响应：
{
"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
}错误响应：
{
"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 |