宝塔面板官方文档

批量为域名设置 DNS API 解析记录

批量为多个域名设置 DNS API 解析记录（自动添加/更新 DNS 解析）。

POST

https://your-panel.example.com:8888/site

更新于 2026年7月10日查看 Markdown

Request bodyX-WWW-FORM-URLENCODEDrequired

request_timestringrequired
Unix 时间戳。

request_tokenstringrequired
按 API 概览生成的签名。
actionset_dns_domainsrequired
具体操作名称。
domainsstringrequired
JSON 数组，域名列表 ["example.com","test.com"]

Returns

default

接口响应，业务状态见下方详细说明。

JSON

statusoptionalboolean
true 操作完成
success_listoptionalarray ofunknown
设置成功的域名列表
err_listoptionalarray ofunknown
设置失败的域名及错误信息

各操作详细说明

set_dns_domainsaction=set_dns_domains批量为域名设置 DNS API 解析记录

批量为多个域名设置 DNS API 解析记录（自动添加/更新 DNS 解析）。

路由：POST /site
action：set_dns_domains

输入参数

参数名称	必选	类型	描述
action	是	String	固定值 `set_dns_domains`
domains	是	String	JSON 数组，域名列表 `["example.com","test.com"]`

输出参数

参数名称	类型	描述
status	Boolean	`true` 操作完成
success_list	Array	设置成功的域名列表
err_list	Array	设置失败的域名及错误信息

示例

请求

POST /site HTTP/1.1
Host: 192.168.168.213:8888
Content-Type: application/x-www-form-urlencoded

action=set_dns_domains&domains=["test.com"]

响应

{"status": true, "msg": "", "success_list": [], "err_list": [{"domain": "test.com", "error": "没有找到域名为test.com的有效的DNS API密钥信息"}]}

批量为域名设置 DNS API 解析记录

curl --request POST \
  --url "https://your-panel.example.com:8888/site" \
  --header "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "request_time=<Unix时间戳>" \
  --data-urlencode "request_token=<按 API 概览生成的签名>" \
  --data-urlencode "action=set_dns_domains" \
  --data-urlencode "domains=<domains>"

Response example

{
  "status": true,
  "msg": "",
  "success_list": [],
  "err_list": [
    {
      "domain": "test.com",
      "error": "没有找到域名为test.com的有效的DNS API密钥信息"
    }
  ]
}