读取协议完整版本¶
请求参数¶
路径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组四语布局,真实运行库未写入测试正文。