为网站快速创建或关联 FTP 账户

为指定网站创建或关联 FTP 账户。

POST

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

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

Request bodyX-WWW-FORM-URLENCODEDrequired

request_timestringrequired
Unix 时间戳。

request_tokenstringrequired
按 API 概览生成的签名。
actionset_sites_ftprequired
具体操作名称。
ftp_namestringrequired
FTP 用户名
ftp_pwdstringrequired
FTP 密码
siteNameoptionalstring
网站域名（与 site_id 二选一）
site_idoptionalinteger
网站 ID
ftp_idoptionalinteger
已有 FTP 账户 ID（关联已有账户时传）
ftp_statusoptionalstring
FTP 状态

Returns

default

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

JSON

statusoptionalboolean
true 操作成功
infooptionalobject
FTP 账户详情（id、name、password、path、status）

各操作详细说明

set_sites_ftpaction=set_sites_ftp为网站快速创建或关联 FTP 账户

为指定网站创建或关联 FTP 账户。

路由：POST /site
action：set_sites_ftp

输入参数

参数名称	必选	类型	描述
action	是	String	固定值 `set_sites_ftp`
siteName	条件	String	网站域名（与 `site_id` 二选一）
site_id	条件	Integer	网站 ID
ftp_name	是	String	FTP 用户名
ftp_pwd	是	String	FTP 密码
ftp_id	否	Integer	已有 FTP 账户 ID（关联已有账户时传）
ftp_status	否	String	FTP 状态

输出参数

参数名称	类型	描述
status	Boolean	`true` 操作成功
info	Object	FTP 账户详情（`id`、`name`、`password`、`path`、`status`）

示例

请求

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

action=set_sites_ftp&siteName=testapi.bt.local&ftp_name=testftp&ftp_pwd=Test@123

响应

{"status": true, "msg": "添加成功", "info": {"id": 4, "pid": 1, "name": "testftp", "password": "Test@123", "path": "/www/wwwroot/testapi.bt.local", "status": "1"}}