/api-design
Posts touching api design.
8 posts
- January 20, 2025 5 min
Migrating from REST to a hybrid REST/event architecture without stopping the train
Our reconciliation engine needed async event processing but API consumers expected synchronous responses. The strangler fig pattern applied to a fintech data pipeline.
- /kafka
- /architecture
- /api-design
- /node
- /blog
- November 25, 2024 4 min
Why our compliance team rewrites my API specs and I have learned to be grateful
In fintech, your API surface is a regulatory document. Our compliance officer started redlining my OpenAPI specs and improved our API design more than any tech review.
- /api-design
- /fintech
- /cross-functional
- /security
- /experience
- August 28, 2024 3 min
Why every API endpoint at FinanceOps returns the same error shape
Our frontend had seven different error format handlers. I standardized every endpoint to return the same discriminated union error shape.
- /api-design
- /typescript
- /node
- /fintech
- /blog
- July 17, 2024 4 min
Why we picked React Server Components over a separate API layer
I tried React Server Components for our internal dashboard and realized I could eliminate the entire API serialization layer for read-heavy pages.
- /react
- /node
- /architecture
- /api-design
- /blog
- June 26, 2024 4 min
TypeScript 5.5 inferred type predicates changed how I write validation code
TypeScript 5.5 shipped inferred type predicates and it quietly eliminated an entire category of boilerplate in our codebase.
- /typescript
- /api-design
- /blog
- May 29, 2024 4 min
Building a real-time notification system with zero external dependencies
We needed real-time payment notifications but could not justify Redis or a managed WebSocket service. SSE and PostgreSQL LISTEN/NOTIFY did the job.
- /node
- /react
- /api-design
- /architecture
- /blog
- May 8, 2024 4 min
Designing a multi-tenant PostgreSQL schema that does not make you cry at 3am
Shared database, shared schema, row-level security. That was the bet. Here is how it played out.
- /postgres
- /architecture
- /fintech
- /api-design
- /blog
- April 24, 2024 4 min
The mass migration: moving 200 API endpoints to TypeScript strict mode in one sprint
A production bug from an unchecked null cost us a weekend. I spent the next sprint converting 200 API endpoints to strict mode.
- /typescript
- /api-design
- /architecture
- /blog