GET/api/v1/agreements/{type}/{contentVersion}
匿名App公共头,JSON沿用JWE与HTTPS策略JSON 响应接入指南 ↗

读取已生效的精确协议版本

请求参数

此入口用于精确历史正文读取;当前阅读优先使用地址目录,新客户端按IP布局选择范围。路径type为terms/privacy/recharge/vip,contentVersion是单份正文版本,不是登录requiredVersion。查询locale、jurisdiction、serviceRegion均必填;国内zh-CN/CN/domestic,国际四语之一/GLOBAL/overseas。旧历史法域保留;不跨版本或语言补缺。

匿名可读,仍要求App八项公共头及JWE协议。实际HTTPS与显式dev固定码例外沿用App安全策略。草稿、未知或未来生效版本统一404。

请求示例

await api.request({path:'/api/v1/agreements/terms/reviewed-v1',method:'GET',
  query:{locale:'zh-CN',jurisdiction:'CN',serviceRegion:'domestic'}});

统一api提供Accept-Language、X-Client-Type=app、X-Platform、X-App-Version、X-App-Build、X-Channel、持久安装X-Device-Id、每次新X-Request-Id和X-Request-Timestamp;GET密文放X-Budyoo-JWE,没有业务正文。

成功响应

HTTP200,Cache-Control:no-store,data包含id(UUID)、type、title、locale、jurisdiction、serviceRegion、contentVersion、bodyHtml、effectiveAt(ISO8601)、url(同源相对/legal/agreements/{id})及contentHash(SHA256)。以上均不为null,正文已做服务端HTML白名单净化。不返回草稿发布资料、管理员或未完成项。

失败响应

400公共头/参数/加密错误;401携带无效凭据;403非App客户端;404内容未发布、生效时间未到或版本/语言/范围不匹配;426要求HTTPS;503数据库或Redis不可用。使用公共错误结构,不泄露后台草稿。

接入说明

优先使用四类目录确认requiredVersion与登录期望一致,再打开返回的HTML链接。后台保存即生效且保留旧正文;本只读入口不修改任何版本或同意记录。精确读取使用目录contentVersion,不能把全局同意版本直接放进此路径。旧未公开历史仍不可读。本次保存即生效的服务器及实际部署范围随目录交付更新。