更新 SMTP 设置

PUT

/api/v1/admin/settings/smtp

Owner 专属，需要 manage_system_settings 权限；浏览器会话还需要 CSRF。

请求参数

Body 参数application/json必填

示例

{
    "host": "string",
    "port": 1,
    "username": "string",
    "from_address": "string",
    "ssl_enabled": true,
    "force_auth_login": true,
    "password_action": "keep",
    "password": "pa$$word"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT '/api/v1/admin/settings/smtp' \
--header 'Content-Type: application/json' \
--data '{
    "host": "string",
    "port": 1,
    "username": "string",
    "from_address": "string",
    "ssl_enabled": true,
    "force_auth_login": true,
    "password_action": "keep",
    "password": "pa$$word"
}'

返回响应

🟢200成功

application/json

已更新的 SMTP 设置；password 永不回显

Bodyapplication/json

示例

{
    "host": "string",
    "port": 1,
    "username": "string",
    "from_address": "string",
    "ssl_enabled": true,
    "force_auth_login": true,
    "password_configured": true
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠413

🟠415

🟠422参数错误

🔴503服务器故障

修改于 2026-10-01 05:59:34

获取公开注册设置

获取登录保持时间