不要依赖未声明的稳定性
文档更新时间是内容核对时间,不是服务器、客户端或合约版本号。代码合入、安装包版本和指定环境部署分别验证。
当前健康接口没有公开版本化契约。客户端应验证必需字段、容忍额外字段、处理无法解析的响应;字段不兼容时停止正常展示并提示重新核对文档。
错误与降级策略
| 情况 | 建议处理 |
|---|---|
| ok=false | 显示降级和最近探测时间,不能显示健康。 |
| 网络失败或超时 | 终止本次等待;人工重试或有上限地退避,不无限循环。 |
| 401 / 403 | 核对目标服务与权限;不要通过关闭认证绕过。 |
| 429 | 遵循服务端提示并减少频率。 |
| 非 JSON / 字段不兼容 | 按不兼容处理,记录脱敏错误并核对接口。 |
| 签名失效或会话过期 | 重新开始完整登录流程,不重放旧签名。 |
密钥不进入浏览器和文档
- 不要收集、复制或写入助记词、恢复密钥、私钥和 API 密钥。
- 登录回执与会话令牌不能放入 URL、公开日志或客服截图。
- 限权操作授权必须明确范围、有效期与撤销方式;恢复密钥不能作为 session key。
- 服务端验证身份和权限;浏览器声称已登录、传入一个账号 ID 或钱包地址都不能代替验证。
- 示例不需要凭据。未来示例只使用明确的占位值与测试资产,不输出敏感配置。