API·检查域名状态 | 宝塔面板官方文档

POST /api/v1/dns/manage/check_domain_status 接口，查询指定域名的注册信息、NS 当前/期望记录与解析状态，适用于判断 NS 是否已指向宝塔云解析。

检查域名状态

接口描述

检查指定域名的详细状态信息，包括注册信息、DNS 配置、解析状态等。

接口地址： POST /api/v1/dns/manage/check_domain_status

输入参数

请求示例

{
  "domain_id": 14,
  "domain_type": 2
}

请求参数

参数名称	必选	类型	描述
domain_id	是	Integer	域名 ID
domain_type	是	Integer	域名类型：1（平台域名）、2（外部域名）

输出参数

响应示例

成功响应：

{
  "code": 0,
  "data": {
    "check_result": 0,
    "check_time": "2025-09-09 15:19:17",
    "current_ns": [],
    "domain_id": 14,
    "domain_type": 2,
    "expected_ns": [
      "ns1.51dns.com",
      "ns2.51dns.com"
    ],
    "full_domain": "example.com",
    "status_text": "检测中"
  },
  "msg": "DNS状态检测完成",
  "status": true
}

错误响应：

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

响应参数

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

data 字段说明：

参数名称	类型	描述
check_result	Integer	检查结果状态码
check_time	String	检查时间
current_ns	Array	当前 DNS 服务器列表
domain_id	Integer	域名 ID
domain_type	Integer	域名类型：1（平台域名）、2（外部域名）
expected_ns	Array	期望的 DNS 服务器列表
full_domain	String	域名名称
status_text	String	状态描述文本

状态说明

检查结果状态码 (check_result)

状态码	描述
0	检测进行中
1	检测成功，DNS配置正确
2	检测失败，DNS配置错误

域名类型 (domain_type)

类型值	描述
1	平台域名
2	外部域名