Blog

  • Visual API Design vs. Writing YAML by Hand

    Let’s talk about YAML. Specifically, let’s talk about the hundreds (or thousands) of lines of it that make up a typical OpenAPI specification. If you’ve ever spent an afternoon debugging an API spec only to discover the problem was a...

  • Programmatically Manipulating OpenAPI Documents in Java and TypeScript

    There comes a point in every API team’s life where you need to do something programmatic with your OpenAPI specs. Maybe you’re building a custom linter. Maybe you need to merge specs from multiple services. Maybe you want to auto-generate...

  • Design-First vs Code-First APIs: Why Apitomy Bets on Design-First

    If you’ve been building APIs for more than five minutes, you’ve probably run into The Debate: should you design your API spec first and generate code from it, or write code first and generate the spec from annotations? Both camps...

  • What is Apitomy? An API-First Toolkit for Modern Teams

    We’ve all been there. You sketch out an API on a whiteboard (or in a text file at 2am), then spend the next week hand-editing YAML, writing boilerplate server code, keeping specs and implementations in sync, and triaging the issues...

  • Welcome to Apitomy

    We’re excited to introduce Apitomy – a new open source brand for tools built around API and Schema specifications.