On this page
Concepts and Request Contract
Objects
- A gateway is the logical API product owned in Build.
- An operation is one reviewed capability with strict request and response schemas.
- A contract version is an immutable compilation of approved operations.
- A publication activates one contract version for one environment and visibility.
- A client binding joins one registered client to one gateway, environment, audience, and scope set.
Envelope
Every new public client sends:
| Field | Meaning |
|---|---|
contract | Must be batoi.public-api/1. |
gateway | Published gateway UID fixed by the client binding. |
operation | Operation key contained in the active contract. |
environment | sandbox, beta, or production; must match the binding. |
method | Logical method recorded in the operation contract. |
request | Strict JSON object validated against the operation schema. |
The caller cannot choose an internal route, table, workspace, Project, App, target URL, or handler. Those bindings are private compiler inputs.
Fail-closed behavior
An operation is unavailable when it is absent from the active contract, its schema hash differs, its publication expired or was revoked, its environment or audience differs, or the client lacks its scope.