Orders — API contract
binding spec openapi/orders.openapi.yaml @ 3.1.0 — the spec of record. It states what must be; implementations converge on it, never the reverse.
Enforced by
check:version— any change must bump the artifact and service versions; a silent edit fails CIcheck:compat— a breaking change must take a major version- Spectral lint, house naming rules included
- Microcks contract tests — mocks and implementations are held to these operations
Version history
| Version | First released | Service version |
|---|---|---|
3.1.0 | 2026-08-30 | 3.2.0 |
3.0.1 | 2026-08-29 | 3.1.0 |
3.0.0 | 2026-08-27 | 3.0.0 |
2.1.0 | 2026-08-23 | 1.0.0 |
Consume it
- Agents, over MCP:
get_artifact('orders', 'openapi/orders.openapi.yaml') - Raw spec:
openapi/orders.openapi.yaml - Implementations pin the release tag
orders/v3.2.0in theircontracts.lockand fetch read-only — the full loop is on Drive an implementation.