ZOOBC / СПРАВОЧНИК API
API шлюза ZooBC
Документация по API шлюза ZooBC, включая эндпоинты прокси, статуса, списка разрешённых узлов, релизов и CORS.
Выберите сеть
Каждый шлюз документирует маршруты, которые действительно обслуживает. Справочник генерируется из работающего бинарного файла, а не пишется параллельно с ним.
MainNet откроется 14 февраля 2027 года
01 / ОДИН БАЗОВЫЙ URL
Всё находится в /api/v1
Весь API блокчейна находится по пути /api/v1 на любом шлюзе, в том же источнике (origin), что и его справочная страница. Не нужно согласовывать 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, который оно описывает.