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

查询协议当前及历史版本

请求参数

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