Bookstore

The go-zero official example: an API gateway that delegates to a backend RPC service, using MySQL for storage.

Architecture

Client → bookstore-api (HTTP) → bookstore-rpc (gRPC) → MySQL

Repository

git clone https://github.com/zeromicro/go-zero.git
cd go-zero/example/bookstore

Services

Service	Port	Description
`api/`	8888	HTTP gateway
`rpc/`	8080	gRPC book service

Start RPC

cd rpc
go run bookstore.go -f etc/bookstore.yaml

Start API

cd api
go run bookstore.go -f etc/bookstore-api.yaml

Test

# Add a book
curl -X POST http://localhost:8888/add \
  -H "Content-Type: application/json" \
  -d '{"book":"The Go Programming Language","price":42}'

# Check stock
curl "http://localhost:8888/check?book=The+Go+Programming+Language"

Key Concepts Demonstrated

API gateway routing to RPC backend
goctl model generation from MySQL DDL
ServiceContext wiring of RPC client