宝塔面板官方文档

为网站添加新域名绑定

为已有网站添加额外域名绑定。

POST

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

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

Request bodyX-WWW-FORM-URLENCODEDrequired

request_timestringrequired
Unix 时间戳。
request_tokenstringrequired
按 API 概览生成的签名。
actionAddDomainrequired
具体操作名称。
idintegerrequired
网站 ID
webnamestringrequired
网站主域名
domainstringrequired
要添加的新域名

Returns

default

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

JSON

domainsoptionalarray ofunknown
添加后的完整域名列表

各操作详细说明

AddDomainaction=AddDomain为网站添加新域名绑定

为已有网站添加额外域名绑定。

路由：POST /site
action：AddDomain

输入参数

参数名称	必选	类型	描述
action	是	String	固定值 `AddDomain`
id	是	Integer	网站 ID
webname	是	String	网站主域名
domain	是	String	要添加的新域名

输出参数

参数名称	类型	描述
domains	Array	添加后的完整域名列表

示例

请求

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

action=AddDomain&id=1&webname=testapi.bt.local&domain=new.example.com

响应

{"domains": [{"name": "testapi.bt.local"}, {"name": "api-test.example.com"}, {"name": "new.example.com"}]}

为网站添加新域名绑定

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=AddDomain" \
  --data-urlencode "id=<id>" \
  --data-urlencode "webname=<webname>" \
  --data-urlencode "domain=<domain>"

Response example

{
  "domains": [
    {
      "name": "testapi.bt.local"
    },
    {
      "name": "api-test.example.com"
    },
    {
      "name": "new.example.com"
    }
  ]
}