Mar 4 · 4 min read · Most teams design APIs one of two ways: write code first and extract OpenAPI from annotations, or write OpenAPI YAML directly and generate types from it. Both have the same problem — you end up maintaining two things (schema + code) that need to stay...
Join discussionMar 3 · 10 min read · Code Generation Tools: When Codegen Helps and When It Creates Tech Debt Code generation sits on a spectrum. On one end, you have tools that generate types from a schema -- strictly additive, easy to regenerate, hard to screw up. On the other end, you...
Join discussionMar 3 · 8 min read · API Testing Tools: Clients, Mocking, Load Testing, and OpenAPI Testing APIs requires different tools at different stages: interactive clients for exploration, mocking tools for development, automated tests for CI, and load testing for production read...
Join discussionMar 3 · 5 min read · API Design Tools: OpenAPI, Swagger, and API-First Development Most APIs are designed by accident. Someone writes a handler, returns some JSON, and the "API" is whatever the code happens to produce. API-first development flips this: you design the API...
Join discussionFeb 18 · 8 min read · TL;DR Stop manually writing API server or client code. Define your API schema first with OpenAPI, then auto-generate type-safe server stubs (Go) and client API code (Dart/Flutter). This workflow eliminates boilerplate, prevents integration bugs, and...
Join discussion
Feb 16 · 10 min read · OpenAPI Contract Testing For API Reliability When your mobile app crashes because the backend team renamed a field from userId to user_id, you've experienced the pain of broken API contracts. This isn't a hypothetical scenario—it's a daily reality fo...
Join discussion
Feb 12 · 10 min read · Why Traditional API Testing Fails at Scale Traditional approaches to API testing rely heavily on end-to-end integration tests that spin up entire service environments, make HTTP calls, and assert on response structures. These tests are slow, brittle,...
Join discussionFeb 12 · 12 min read · Article Body Modern API development teams face a critical decision that impacts developer experience, integration speed, and long-term maintainability: choosing the right API documentation specification. With microservices architectures dominating en...
Join discussionFeb 12 · 6 min read · OpenAPI Specification: Design APIs That Scale The API That Broke Everything (And How Documentation Could Have Saved Us) Our undocumented API changes broke 50 client apps. Here's what we learned the hard way. Table of Contents API Development 2026 De...
Join discussionFeb 9 · 2 min read · Today ChatGPT lied to me, so I’m setting the record straight. This is my question: “If an endpoint in an OpenAPI spec has multiple tags, what will Swagger Codegen do?”. Because Swagger Codegen organized the generated code into api/tag_name_api files....
Join discussion