净化并预览协议¶
请求参数¶
OWNER/VIEWER均可预览。要求独立Cookie、HTTPS、JWE、同源Origin及X-Admin-CSRF,八项公共头固定admin/web/admin_web。无路径或查询参数。
| 正文字段 | 类型/必填 | 约束 |
|---|---|---|
| type | string,是 | terms/privacy/recharge/vip |
| locale/serviceRegion | string,是 | 国内zh-CN/domestic,国际四语之一/overseas |
| jurisdiction | string,否 | 省略自动归一CN/GLOBAL |
| title | string,是 | 非空,最多120个UTF-16代码单元 |
| bodyHtml | string,是 | 最多60000个UTF-16代码单元、160000个UTF-8字节,净化后非空 |
| contentVersion | string,否 | 可省略;传入时符合1–64位ASCII内容版本规则 |
| summary | string,否 | 默认空,最多500个UTF-16代码单元 |
| publicationFields | object,否 | 默认{},受控键对应string值,每项最多2000个UTF-16代码单元 |
| legalReviewed | boolean,否 | 默认false,不接受字符串或数字 |
| effectiveAt | ISO8601或null,否 | 兼容旧字段,预览不安排生效时间 |
请求示例¶
await request('agreements/preview', 'POST', {
type: 'terms', locale: 'en', serviceRegion: 'overseas',
title: 'Terms of Service', bodyHtml: '<p>待预览的正文。</p>'
});
后台封装提供Accept-Language及完整八项X-*元数据、Cookie、Origin、CSRF和JWE;不自行拼接认证材料。
成功响应¶
HTTP200、no-store,data为bodyHtml(string,净化后的HTML)、missingFields(string[],资料补全提示)、publicationReady(boolean,结构及地区组合通过)和sanitized(boolean,输入是否被净化或规范化)。字段均非null。
本接口不创建记录、不切换当前正文、不更新同意版本。预览成功后点击保存才立即生效。
失败响应¶
400 INVALID_AGREEMENT/AGREEMENT_IMPORTANT_REQUIRED/INVALID_CLIENT_HEADERS/加密错误;401 UNAUTHORIZED;403 FORBIDDEN/ADMIN_CSRF_INVALID;426 HTTPS_REQUIRED;503 SERVICE_UNAVAILABLE。code固定,提示四语。
{"code":"AGREEMENT_IMPORTANT_REQUIRED","message":"对应当前语言的重要条款完整性提示","data":null,"errors":[]}
接入说明¶
服务器使用HTML解析器白名单过滤脚本、事件、任意CSS、iframe、表单、外部图片和危险URL;国内重要区及法定例外完整性校验保留。前端使用无脚本编辑/预览环境;不能用客户端过滤替代服务端校验。
2026-11-04已随V19与新版后台配套部署,417项服务器Java回归零失败/错误/跳过,覆盖保存生效、旧正文保留、同意版本、并发、权限/JWE/CSRF、审计回滚与迁移。公网60组旧渠道语言组合、7项访问边界及20个独立HTML链接只读验证通过;运行库原20份正文与UUID保持,未伪造法律复核。后台保存交互另通过18项浏览器夹具及24组四语布局,真实运行库未写入测试正文。