可用性
设计原则
- 以只读方式公开访问区块链公共数据。
- 不进行任何写入、签名或钱包管理操作。
- 不直接暴露节点的 RPC。
- 对响应进行缓存并限制速率，以保护基础设施。
- API 不可用不会影响网站浏览。
- 在投入服务之前记录模式、错误代码和限制。
计划资源
- 服务状态
- API 可用性、公共链高度和网络基本信息。
- 区块
- 分页区块列表以及按高度或公开标识符查询区块。
- 交易
- 按标识符查询公共交易。
- 地址
- 地址的公开历史记录，不包含任何钱包私人数据。
- 网络
- 关于对等节点和同步状态的公开信息，经过汇总且不敏感。
路径、响应格式、分页参数和速率限制将在 API 开放前发布的版本化规范中确定。
网站集成
网站旨在保持自主。未来的任何集成都将通过服务器端的专用访问层进行，并带有超时、响应验证和明确的不可用状态。
- 生产环境中不得显示任何演示数据。
- 不可用的响应必须产生一个明确标识的空状态。
- API 错误不应泄露基础设施信息。
- 网站绝不应依赖 API 来显示其静态页面。