Skip to content
~/sph.sh

openapi

2 posts

API Versioning Strategies in Practice: From First Release to Sunset

A comprehensive guide to API versioning strategies covering URL vs header approaches, breaking changes, deprecation with Sunset headers, AWS API Gateway patterns, GraphQL evolution, and consumer-driven contract testing.

api-designversioningrest-api+7
Zod + OpenAPI + AWS Lambda: How Documentation Drift Led Me to Schema-First Development

How a 'simple' API change broke an enterprise client integration overnight, why documentation drift causes real problems, and a practical system that generates OpenAPI specs from Zod schemas automatically.

api-gatewayaws-cdklambda+5