ZOOBC / RIFERIMENTO API
API del gateway di ZooBC
Documentazione delle API del gateway di ZooBC, inclusi gli endpoint proxy, status, allowlist, release e CORS.
Scegli una rete
Ogni gateway documenta le route che espone davvero. Il riferimento è generato dal binario in esecuzione, non scritto a parte.
La MainNet apre il 14 febbraio 2027
01 / UN SOLO URL DI BASE
Tutto sotto /api/v1
L'intera API della catena si trova sotto /api/v1 su qualsiasi gateway, con la stessa origine della sua pagina di riferimento. Nessun CORS da negoziare, nessuna chiave da ottenere, nessun piano tariffario.
curl -s https://zoobc.network/api/v1/blockchain/status restituisce l'altezza, l'altezza confermata e l'ultimo blocco. È la chiamata utile più breve e un buon primo controllo per capire se un gateway è attivo.
02 / LETTURE E SCRITTURE
Vanno in posti diversi
Una GET viene inoltrata tramite proxy a un nodo di archivio, che conserva la cronologia completa: blocchi, transazioni e account a qualsiasi altezza. Una POST viene inoltrata direttamente a un nodo completo, mai a un nodo di archivio, perché l'invio di una transazione richiede una mempool.
Questa suddivisione conta più di quanto sembri. Un nodo di archivio è un servizio di cronologia in sola lettura e rispondeva alle POST con un 404: ecco perché un tempo la trasmissione tramite un gateway non funzionava. La guida per sviluppatori tratta per intero l'instradamento e l'allowlist.
03 / PER I PROGRAMMI
Leggerla senza browser
Il gateway pubblica una guida leggibile dalle macchine per la stessa API su agents.md, con un file di scoperta su llms.txt e un esempio Python di riferimento senza dipendenze su zoobc-agent-example.py.
Sono serviti accanto alla catena di proposito: una guida che spiega a un programma come spendere denaro deve provenire dalla stessa origine dell'API che descrive.