建设中

建设中:我们正在 MainNet 上线前搭建本网站,细节会有变动。

本网站仍在建设中

ZooBC 在公开中建设。你在这里看到的内容是最新且真实的,但并不完整:请把它看作我们当前的状态,而不是最终定论。

从现在到 MainNet 上线,措辞、结构、图片和数据都会有变动。部分页面仍是占位内容。

更广泛的 ZooBC 生态将分阶段到来。随着 MainNet 临近,钱包、区块浏览器和社区渠道会陆续上线,本网站也会随之成长。

如果有内容读起来不对、看起来有问题或可能造成误导,请告诉我们。现在的反馈,比日后精致的发布对我们更有价值。

ZOOBC / API 参考

ZooBC 网关 API

ZooBC 网关 API 文档,包括代理、状态、白名单、发布和 CORS 端点。

选择网络

每个网关都会记录它实际提供的路由。参考文档由运行中的二进制程序生成,而不是另行编写。

TestNetzoobc.network
MainNetzoobc.net
打开 API 参考

MainNet 将于 2027 年 2 月 14 日上线

01 / 唯一的基础 URL

一切都在 /api/v1 之下

整个链 API 都位于任一网关的 /api/v1 之下,与其参考页面同源。无需处理 CORS,无需申请密钥,也没有调用套餐。

curl -s https://zoobc.network/api/v1/blockchain/status 返回高度、已确认高度和最新区块。这是最短的有用调用,也很适合作为检查网关是否在线的第一步。

02 / 读与写

它们去往不同的地方

GET 请求会被代理到归档节点,它保存着完整的历史:任意高度下的区块、交易和账户。POST 请求则直接代理到全节点,绝不会发往归档节点,因为提交交易需要内存池。

这种分流比听上去更重要。归档节点是只读的历史服务,过去会对 POST 返回 404,这就是为什么一度无法通过网关广播交易。开发者指南完整介绍了路由和白名单。

03 / 面向程序

无需浏览器即可读取

网关在 agents.md 发布了同一 API 的机器可读指南,在 llms.txt 提供发现文件,并在 zoobc-agent-example.py 提供零依赖的 Python 参考实现。.

它们特意与链部署在一起:一份告诉程序如何花钱的指南,应当与它所描述的 API 同源。