02 — Capability · BC-1240.10
API Design & Governance
Design public APIs that are consistent, predictable and hard to misuse, and change them without breaking the people who already depend on them.
- API Standards
- API Lifecycle
- API Versioning
In scope
- API design guidelines and review
- Versioning and deprecation policy for public contracts
- API specification as the source of truth
Out of scope
- Internal service-to-service contracts (see BC-1210)
Realized by · 0
- No product in the catalog yet.
Used in · 0
- Not yet placed on a value stream.
Build it · 4
Decomposes into · 4
- BC-1240.10.10API Design StandardsPublish and enforce naming, error, pagination and authentication conventions so every endpoint feels like the same product.
- BC-1240.10.20API Specification & Contract ReviewTreat the machine-readable specification as the contract, review changes against it and generate docs and clients from it.
- BC-1240.10.30API Versioning & DeprecationIntroduce breaking changes only behind a new version, with a published sunset date and migration guidance for the old one.
- BC-1240.10.40Webhooks & Event ContractsDefine the outbound events the product emits, their payloads and delivery guarantees, so integrators can react instead of poll.