ZOOBC / APIリファレンス
ZooBCゲートウェイAPI
プロキシ、ステータス、許可リスト、リリース、CORSの各エンドポイントを含む、ZooBCゲートウェイAPIのドキュメント。
ネットワークを選択
各ゲートウェイは、実際に提供しているルートを文書化しています。リファレンスは稼働中のバイナリから生成されたもので、別途書き起こしたものではありません。
MainNetは2027年2月14日に開始
01 / ベースURLは1つ
すべては/api/v1の下に
チェーンAPIはすべて、どのゲートウェイでも/api/v1の下にあり、リファレンスページと同一オリジンです。CORSの調整も、キーの取得も、料金プランも不要です。
curl -s https://zoobc.network/api/v1/blockchain/status は、高さ、確認済みの高さ、最新ブロックを返します。最も短く、しかも役に立つ呼び出しであり、ゲートウェイが稼働しているかを最初に確認するのに適しています。
02 / 読み取りと書き込み
行き先が異なる
GETはアーカイブノードにプロキシされます。アーカイブノードは、任意の高さ時点でのブロック、トランザクション、アカウントといった深い履歴を保持しています。POSTはアーカイブノードではなく、常にフルノードへ直接プロキシされます。トランザクションの送信にはメンプールが必要だからです。
この分離は見た目以上に重要です。アーカイブノードは読み取り専用の履歴サービスで、以前はPOSTに404を返していました。かつてゲートウェイ経由のブロードキャストが機能しなかったのはそのためです。ルーティングと許可リストの詳細は開発者ガイドで解説しています。
03 / プログラム向け
ブラウザなしで読む
同じAPIの機械可読なガイドを、ゲートウェイがagents.mdで公開しています。ディスカバリーファイルはllms.txt、依存関係のないPythonリファレンスはzoobc-agent-example.pyにあります。.
これらはあえてチェーンと同じ場所で提供しています。プログラムにお金の使い方を教えるガイドは、それが説明するAPIと同じオリジンから提供されるべきだからです。