ZOOBC / RÉFÉRENCE DE L'API
API de la passerelle ZooBC
Documentation de l'API de la passerelle ZooBC, y compris les points de terminaison de proxy, d'état, de liste d'autorisation, de publication et CORS.
Choisissez un réseau
Chaque passerelle documente les routes qu'elle sert réellement. La référence est générée à partir du binaire en cours d'exécution, et non rédigée à côté.
Ouverture du MainNet le 14 février 2027
01 / UNE SEULE URL DE BASE
Tout sous /api/v1
Toute l'API de la chaîne se trouve sous /api/v1 sur n'importe quelle passerelle, à la même origine que sa page de référence. Pas de CORS à négocier, pas de clé à obtenir, pas de forfait de débit.
curl -s https://zoobc.network/api/v1/blockchain/status renvoie la hauteur, la hauteur confirmée et le dernier bloc. C'est l'appel utile le plus court, et une bonne première façon de vérifier qu'une passerelle est en vie.
02 / LECTURES ET ÉCRITURES
Elles ne vont pas au même endroit
Un GET est relayé vers un nœud d'archive, qui conserve l'historique profond : blocs, transactions et comptes à n'importe quelle hauteur. Un POST est relayé directement vers un nœud complet, jamais vers l'archive, car soumettre une transaction nécessite une mempool.
Cette séparation compte plus qu'il n'y paraît. Un nœud d'archive est un service d'historique en lecture seule qui répondait autrefois aux POST par une 404, ce qui explique pourquoi la diffusion via une passerelle n'a pas fonctionné pendant un temps. Le guide du développeur détaille le routage et la liste d'autorisation.
03 / POUR LES PROGRAMMES
La lire sans navigateur
Un guide de la même API, lisible par machine, est publié par la passerelle à agents.md, avec un fichier de découverte à llms.txt et une référence Python sans dépendance à zoobc-agent-example.py.
Ils sont servis à côté de la chaîne à dessein : un guide qui explique à un programme comment dépenser de l'argent doit provenir de la même origine que l'API qu'il décrit.