GET/legal/agreements/{id}
匿名,已发布且生效;prod必须HTTPSJSON 响应接入指南 ↗

打开已生效协议网页

请求参数

路径id必填UUID,来源于协议地址目录,无查询参数或正文。WebView可直接打开,不带Bearer、Cookie、公共元数据或JWE。正文语言由文档版本固定,Accept-Language不能把该UUID切换到其他语言。

prod必须HTTPS。只有dev且明确启用development-fixed-code及allow-insecure-development才允许HTTP联调;不会因为客户端Host或转发头而改变要求。

请求示例

// 使用目录返回的绝对url,正常验证HTTPS证书,不添加认证或加密头。
openWebView(agreement.url);

成功响应

HTTP200,Content-Type:text/html;charset=UTF-8。完整HTML包含文档标题、内容版本、生效时间和净化正文。Content-Language为正文语言;Cache-Control:no-store、X-Content-Type-Options:nosniff、X-Frame-Options:DENY、Referrer-Policy:no-referrer。CSP启用sandbox、default-src none,只允许外壳内置样式,禁止脚本、外部资源、表单和页面嵌入。

失败响应

无效UUID400;不存在、草稿或未来生效版本404;禁止的HTTP请求426;依赖不可用503。错误不返回草稿正文。普通WebView根据HTTP状态显示错误与重试。

接入说明

后台保存成功即生效,App使用目录返回的本页地址;修改后返回新UUID,旧已生效地址继续展示原文。旧未公开历史保持404,不能由客户端猜测UUID打开。正文可读不等于法律复核、用户勾选或支付确认完成;实际legalReviewed不会自动设为true。V19保留既有正文和UUID并将最近保存内容接入阅读,当前实际验证以目录交付为准。HTTPS、无凭据阅读、CSP及历史不可变规则保持。