ZOOBC / API 参考
ZooBC 网关 API
ZooBC 网关 API 文档,包括代理、状态、白名单、发布和 CORS 端点。
选择网络
每个网关都会记录它实际提供的路由。参考文档由运行中的二进制程序生成,而不是另行编写。
TestNetzoobc.network
MainNetzoobc.net
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 同源。