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

读取协议完整版本

请求参数

路径id为UUID,无查询或正文。OWNER/VIEWER可读,要求独立Cookie、HTTPS、真实JWE及八项公共头,固定admin/web/admin_web;不接受App身份。

请求示例

await request('agreements/11111111-1111-4111-8111-111111111111', 'GET');

后台封装提供动态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;GET的JWE放在X-Budyoo-JWE,无业务正文。

成功响应

HTTP200,Cache-Control:no-store,外层JWE。data字段如下:

字段 类型/可空 含义
id UUID string,否 固定指向该份正文;修改保存返回另一id
type string,否 terms/privacy/recharge/vip
locale string,否 zh-CN/en/ja/ko
jurisdiction/serviceRegion string,否 CN/domestic或GLOBAL/overseas;旧历史可能保留原法域
contentVersion string,否 该条正文版本,后续编辑由服务器生成新值
title/summary/bodyHtml string,否 标题、摘要及服务端净化HTML
publicationFields object,否 已保存的附加运营资料
legalReviewed boolean,否 实际管理员复核声明,保存生效不会自动变为true
effectiveAt/publishedAt ISO8601 string,是 新保存均非空,旧未公开历史可空
status string,否 新保存PUBLISHED;DRAFT仅兼容旧未公开历史
version integer(int64),否 编辑并发版本,保存后使用响应的新值
currentRevision boolean,否 当前配置位正文;false为历史,不能直接保存覆盖
createdAt/updatedAt ISO8601 string,否 记录创建和更新时间
publicEnabled boolean,否 已保存生效并可按UUID阅读;历史已发布正文仍可读
missingFields string[],否 尚待补充的运营/复核事项,仅作信息,不控制是否再次发布
publicationReady boolean,否 兼容字段,当前合法地区语言组合可保存;不代表法律审核完成
contentHash string,否 净化正文SHA256,64位十六进制

正文可读、当前版本、法律复核是三个不同字段。历史正文保持原内容,不把新文本写回旧阅读链接。新增currentRevision为兼容增加;旧字段保持。

失败响应

400 BAD_REQUEST/INVALID_CLIENT_HEADERS/加密错误;401 UNAUTHORIZED;403 FORBIDDEN/ADMIN_CSRF_INVALID;404 NOT_FOUND;426 HTTPS_REQUIRED;503 SERVICE_UNAVAILABLE。提示四语,固定code不翻译。

{"code":"NOT_FOUND","message":"资源不存在。","data":null,"errors":[]}

接入说明

编辑当前记录须保留id与version;保存成功后更新为新响应。历史只读,仍可用于核对过去内容。读取不改变状态、不记录用户同意或启用付款。

2026-11-04已随V19与新版后台配套部署,417项服务器Java回归零失败/错误/跳过,覆盖保存生效、旧正文保留、同意版本、并发、权限/JWE/CSRF、审计回滚与迁移。公网60组旧渠道语言组合、7项访问边界及20个独立HTML链接只读验证通过;运行库原20份正文与UUID保持,未伪造法律复核。后台保存交互另通过18项浏览器夹具及24组四语布局,真实运行库未写入测试正文。