---
title: "PUT /v1/admin/settings/site"
method: PUT
path: "/v1/admin/settings/site"
tags: ["AdminSiteSettingsService"]
---

# PUT /v1/admin/settings/site

`PUT /v1/admin/settings/site`

UpdateSiteSettings 批量更新站点公开配置。

## Request body

- AdminV1UpdateSiteSettingsRequest
  - `settings` AdminV1SiteSettings — SiteSettings 站点公开配置（写入后经由 /v1/public/site-settings 暴露给 web 首屏）。 字段口径与 site.v1.GetPublicSiteSettingsReply 一致（admin 写、public 读，闭环）。 字段全部用 optional：UpdateSiteSettings 是「部分更新」——请求里显式带的字段才写库， 缺省字段保留原值。站点字段分散在多个前端 tab（平台 / 充值限额）分别提交，若无 presence 语义，缺省字段会被反序列化成零值覆盖，表现为「开放注册被关」「充值限额回退默认」。 读路径（GetSiteSettings）始终把全部字段填满（缺失走默认值），故对读端无影响。
    - `allowRegister` boolean
    - `analyticsScripts` AdminV1AnalyticsScripts — AnalyticsScripts 统计脚本条目集合。用包装消息而非在 SiteSettings 里直接 repeated： proto3 无法区分「缺省 repeated」与「显式空列表」，包装成 optional 消息后由字段 presence 表达 patch 语义——absent = 不修改；present 且 entries 为空 = 清空。
      - `entries` AdminV1AnalyticsScriptEntry[]
        - `attributes` object — attributes 附加 HTML 属性（如 data-website-id）。key 禁止 on* 事件属性及 src/id/strategy 覆盖。
        - `content` string — content 内联 JS 内容（不含 <script> 标签）。
        - `id` string — id 条目稳定标识（React key / next/script 去重）。content 非空时必填；非空 id 需列表内唯一。
        - `src` string — src 外部脚本 URL（https?:// 或以 / 开头，含协议相对 //）。
        - `strategy` string — strategy next/script 加载策略：afterInteractive（空串默认）/ lazyOnload / beforeInteractive / worker。
    - `emailDomainWhitelist` string — email_domain_whitelist 邮箱域名白名单，逗号分隔（如 "qq.com,163.com"）。 空串表示不限制。非空时注册 / 发验证码（未注册邮箱）/ 换绑邮箱仅接受名单内域名。
    - `maintenanceMode` boolean
    - `passwordMinLength` integer
    - `platformName` string
    - `platformNameEn` string — platform_name_en 平台英文名称；空串表示未配置，用户端非中文语言回退 platform_name。
    - `platformUrl` string
    - `realnameEnforceApikeyCreate` boolean — realname_enforce_apikey_create 控制创建 API Key 时是否强制实名认证。
    - `realnameEnforceGateway` boolean — realname_enforce_gateway 控制网关/API 调用时是否强制实名认证。
    - `realnameMethodAlipayCertifyQrEnabled` boolean — 各认证方式的独立开关
    - `realnameMethodAlipayTwoMetaEnabled` boolean
    - `realnameVerifyEnabled` boolean — realname_verify_enabled 控制用户端个人实名认证入口是否可见。
    - `rechargeMax` string
    - `rechargeMin` string — recharge 金额字符串，避免浮点误差（与 site.v1.RechargeLimit 一致）。
    - `supportEmail` string
    - `trialDays` integer
    - `twoFactorRequired` boolean

## Response `200`

OK

- AdminV1UpdateSiteSettingsReply
  - `ok` boolean

---

[API](https://skmtc.dev/apiqik/apis/apiqik-api.md) · [All operations](https://skmtc.dev/apiqik/apis/apiqik-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apiqik/apiqik-api/revisions/e06b96127408/schema)