ZOOBC / REFERENCIA DE LA API
API de la pasarela ZooBC
Documentación de la API de la pasarela ZooBC, incluidos los endpoints de proxy, estado, lista de permitidos, versiones y CORS.
Elige una red
Cada pasarela documenta las rutas que realmente sirve. La referencia se genera a partir del binario en ejecución, no se escribe aparte.
La MainNet apunta al 14 de febrero de 2027, garantizada dentro del T1 de 2027
01 / UNA SOLA URL BASE
Todo bajo /api/v1
Toda la API de la cadena está bajo /api/v1 en cualquier pasarela, en el mismo origen que su página de referencia. Sin CORS que negociar, sin clave que obtener, sin plan de tarifas.
curl -s https://zoobc.network/api/v1/blockchain/status devuelve la altura, la altura confirmada y el último bloque. Es la llamada útil más corta y una buena primera comprobación de que una pasarela está activa.
02 / LECTURAS Y ESCRITURAS
Van a lugares distintos
Un GET se reenvía a un nodo de archivo, que guarda el historial profundo: bloques, transacciones y cuentas a cualquier altura. Un POST se reenvía directamente a un nodo completo, nunca a uno de archivo, porque enviar una transacción necesita un mempool.
Esa división importa más de lo que parece. Un nodo de archivo es un servicio de historial de solo lectura y antes respondía a los POST con un 404, por eso en su momento la difusión a través de una pasarela no funcionaba. La guía para desarrolladores cubre por completo el enrutamiento y la lista de permitidos.
03 / PARA PROGRAMAS
Leerla sin navegador
La pasarela publica una guía legible por máquinas de la misma API en agents.md, con un archivo de descubrimiento en llms.txt y una referencia en Python sin dependencias en zoobc-agent-example.py.
Se sirven junto a la cadena a propósito: una guía que le dice a un programa cómo gastar dinero debe venir del mismo origen que la API que describe.