获取解析记录列表

接口描述

获取指定域名下的 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