Protocol sandbox
The Jade Registry of the Heavenly Office, open to every clerk with a seal.
Your tasks
A code appears when a task is done – type it into the lesson.
Sign in to see your tasks
Tasks check what you did, so they need your account.
The Jade Registry – gRPC
A browser cannot speak gRPC: call the service from Postman or grpcurl. The server uses TLS (grpcs://).
One gRPC service with ten methods: Login for a token, reads and writes of tablets, a server stream, a client stream, a bidirectional stream and a slow oracle to try deadlines on.
| Method | Kind | Token | What it does |
|---|---|---|---|
Login | unary | – | Your sandbox username and password → token and expires_in (seconds). |
GetTablet | unary | no | One tablet by id. NOT_FOUND when there is none for you. |
ListTablets | unary | no | Filters rank, element, status, name_contains, limit (0 → 20, at most 100), offset; answers total and the page. |
CreateTablet | unary | yes | INVALID_ARGUMENT, ALREADY_EXISTS, UNAUTHENTICATED, RESOURCE_EXHAUSTED. |
UpdateTablet | unary | yes | Full replacement. NOT_FOUND, PERMISSION_DENIED for sealed ids, INVALID_ARGUMENT, ALREADY_EXISTS. |
DeleteTablet | unary | yes | NOT_FOUND, PERMISSION_DENIED for sealed ids. |
WatchOmens | server stream | yes | count messages (0 → 10, at most 50), every interval_ms (0 → 1000, 200–5000). |
SubmitReports | client stream | yes | Send Report messages, get one SubmitSummary when you end the stream. |
DragonCouncil | bidirectional | yes | One reply to each message you send; ends when you end the stream. |
ConsultOracle | unary | yes | Answers after delay_ms (0 → 5000, at most 30000): try a deadline or Cancel. |
How to call it from your tools
List the services
GetTablet with grpcurl
Login with grpcurl
CreateTablet with your token
The Heavenly Office keeps a tablet for every power under heaven. Read the twenty sealed tablets without signing in, carve tablets of your own with your token, and call the office in all four ways gRPC knows: one answer, a stream of omens, a stream of reports, and a council that talks back.
Addresses
Sign in on the right first: most calls need your token- gRPC server (TLS)
- gRPC server without reflection – import the .proto here
- gRPC contract – download or import
- REST base URL – sign-in, orders, keys