查询协议当前及历史版本¶
请求参数¶
OWNER/VIEWER可读。独立Cookie、HTTPS、真实JWE及八项公共头必填,admin/web/admin_web。无路径参数、无正文。
| 查询字段 | 类型/默认 | 范围 |
|---|---|---|
| type | string,空 | terms/privacy/recharge/vip |
| locale | string,空 | zh-CN/en/ja/ko |
| jurisdiction | string,空 | CN/GLOBAL或历史两位大写法域 |
| serviceRegion | string,空 | domestic/overseas |
| status | string,空 | PUBLISHED/DRAFT;DRAFT仅兼容旧历史 |
| page | integer,1 | 1–100000 |
| pageSize | integer,20 | 1–100 |
条件按AND组合,空值表示不筛选。新保存直接PUBLISHED,不提供草稿工作流。
请求示例¶
await request('agreements', 'GET', undefined, {
type: 'terms', serviceRegion: 'domestic', locale: 'zh-CN', page: 1, pageSize: 50
});
后台统一封装提供Accept-Language、X-Client-Type、X-Platform、X-App-Version、X-App-Build、X-Channel、X-Device-Id、X-Request-Id、X-Request-Timestamp及Cookie/JWE;查询放URL,GET没有业务正文。
成功响应¶
HTTP200及no-store,JWE解密后data含items、total、page、pageSize。items字段见完整详情,列表bodyHtml=null、publicationFields={};currentRevision为true的当前正文排在历史前,同组再按createdAt及id倒序,总数与列表同快照。
{"code":"SUCCESS","message":"操作成功。","data":{"items":[],"total":0,"page":1,"pageSize":20},"errors":[]}
当前配置位缺失时不跨语或跨地区补正文。历史已生效链接继续固定读取原文,不能用历史id覆盖当前稿。
失败响应¶
400 INVALID_AGREEMENT/BAD_REQUEST/INVALID_CLIENT_HEADERS/加密错误;401 UNAUTHORIZED;403 FORBIDDEN/ADMIN_CSRF_INVALID;426 HTTPS_REQUIRED;503 SERVICE_UNAVAILABLE。提示中英日韩,code不翻译。
接入说明¶
页面默认选择currentRevision=true的条目。历史只读,可返回当前记录编辑;保存响应可能包含新id,后续读取与保存必须采用新值。任何失败或超时都不清除未保存输入,不自动重发写请求。
2026-11-04已随V19与新版后台配套部署,417项服务器Java回归零失败/错误/跳过,覆盖保存生效、旧正文保留、同意版本、并发、权限/JWE/CSRF、审计回滚与迁移。公网60组旧渠道语言组合、7项访问边界及20个独立HTML链接只读验证通过;运行库原20份正文与UUID保持,未伪造法律复核。后台保存交互另通过18项浏览器夹具及24组四语布局,真实运行库未写入测试正文。