ZOOBC / API 참조
ZooBC 게이트웨이 API
프록시, 상태, 허용 목록, 릴리스, CORS 엔드포인트를 포함한 ZooBC 게이트웨이 API 문서.
네트워크 선택
각 게이트웨이는 실제로 제공하는 경로를 문서화합니다. 참조 문서는 코드와 별도로 작성되는 것이 아니라 실행 중인 바이너리에서 생성됩니다.
MainNet은 2027년 2월 14일에 열립니다
01 / 하나의 기본 URL
모든 것은 /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와 같은 출처에서 나와야 하기 때문입니다.