POST/api/v1/admin/agreements/preview
管理员Cookie/HTTPS/JWE/CSRF,ADMIN_AGREEMENTS_READJSON 响应接入指南 ↗

净化并预览协议

请求参数

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组四语布局,真实运行库未写入测试正文。