Skip to content

← Capabilities CAP-03

REST, GraphQL, integrations

API engineering

Public and private APIs that age well — properly versioned, properly documented, properly rate limited.

DOC. IDCAP-03
REV
7.4
STATUS
in production
LAST REVIEW
2026-06-12
METRIC
100%
§ 01 How we approach this CAP-03.body

An API is a contract you have to honour for years. We design REST and GraphQL APIs starting from the failure modes — what happens at 10x traffic, what happens when a downstream goes down, what happens when a client is six versions behind. We document every endpoint with OpenAPI, ship a Postman collection at v1.0, and run a deprecation policy you can put in front of your enterprise customers. Less heroics, more durable behaviour.

§ 02 Stack CAP-03.stack
OpenAPI 3.1HonoFastifyGraphQL YogaPostgREST