跳到正文
浏览文档目录
BUILD WITH A CLEAR BOUNDARY

兼容、错误处理与安全

校验响应结构、按错误类别处理,并保留最小权限。

最后核对 中文核实稿 · v0.1
测试中

只读示例与现有认证流程

不要依赖未声明的稳定性

文档更新时间是内容核对时间,不是服务器、客户端或合约版本号。代码合入、安装包版本和指定环境部署分别验证。

当前健康接口没有公开版本化契约。客户端应验证必需字段、容忍额外字段、处理无法解析的响应;字段不兼容时停止正常展示并提示重新核对文档。

错误与降级策略

情况建议处理
ok=false显示降级和最近探测时间,不能显示健康。
网络失败或超时终止本次等待;人工重试或有上限地退避,不无限循环。
401 / 403核对目标服务与权限;不要通过关闭认证绕过。
429遵循服务端提示并减少频率。
非 JSON / 字段不兼容按不兼容处理,记录脱敏错误并核对接口。
签名失效或会话过期重新开始完整登录流程,不重放旧签名。

密钥不进入浏览器和文档

  • 不要收集、复制或写入助记词、恢复密钥、私钥和 API 密钥。
  • 登录回执与会话令牌不能放入 URL、公开日志或客服截图。
  • 限权操作授权必须明确范围、有效期与撤销方式;恢复密钥不能作为 session key。
  • 服务端验证身份和权限;浏览器声称已登录、传入一个账号 ID 或钱包地址都不能代替验证。
  • 示例不需要凭据。未来示例只使用明确的占位值与测试资产,不输出敏感配置。
文档有误或需要帮助?通过现有支持入口反馈 ↗