https://severinbucher.com/tags/go/Recent content in Go on Severin Bucher | BlogHugoenThu, 24 Apr 2025 00:00:00 +0000https://severinbucher.com/posts/modern-api-development-with-typespec-and-openapi/Thu, 24 Apr 2025 00:00:00 +0000https://severinbucher.com/posts/modern-api-development-with-typespec-and-openapi/<p>Designing clear, well-documented web APIs is a big part of building software. The most widely adopted standard for describing RESTful APIs is OpenAPI, a machine-readable format (usually JSON or YAML) that defines an API&rsquo;s structure, endpoints, and request and response shapes. That schema becomes the single source of truth behind your interactive docs, client libraries, and server stubs.</p> <p>However, writing and maintaining OpenAPI specifications by hand can quickly become a chore. The syntax is verbose, and small mistakes in the structure can lead to frustrating bugs or inconsistencies across different parts of the system.</p>