Lattice API
A typed HTTP API and client SDK for internal tools, designed for predictable errors and easy local development.
- 2024
- maintained
- Tech lead
Overview
Lattice is a placeholder for an internal API platform. Use this page to document how you designed contracts, versioning, and developer experience.
Problem
Multiple services exposed ad-hoc endpoints with inconsistent error shapes and incomplete documentation. Client teams spent time rediscovering the same integration details.
Goals
- One consistent request/response and error model
- Generated types for consumers
- A local development path that does not require a full staging environment
Technical decisions
OpenAPI was treated as the source of truth. Handlers validated input at the edge, and clients were generated from the same schema used in CI contract checks.
Challenges
Backward compatibility required explicit deprecation windows. The team learned to prefer additive changes and clear sunset headers over silent breaking updates.
Outcome
Replace this with adoption metrics, reduced integration time, or fewer production contract incidents.