Best of OpenAPI — 2025

  1. 1
    Article
    Avatar of apievangelistAPI Evangelist·1y

    OpenAPI Doctor is What API Innovation Looks Like Today

    OpenAPI Doctor by Princess B33f Heavy Industries enhances API management by making OpenAPI and Spectral more visually manageable. The tool offers creative visual enhancements and abstracts complex rules to improve usability. It supports exploring API infrastructure with better visibility of requests and responses. Users are encouraged to try it out with their own OpenAPI specs and experience its functionalities, including YAML view and governance rule applications.

  2. 2
    Article
    Avatar of francofernandoThe Polymathic Engineer·48w

    APIs Versioning

    API versioning is essential for managing changes without breaking existing client applications. The guide covers two main strategies: additive changes (backward-compatible modifications) and explicit versioning (maintaining multiple API versions simultaneously). Implementation methods include URL path versioning, custom headers, and query parameters, with URL path being most common. Semantic versioning (Major.Minor.Patch) provides clear communication about change types. Proper lifecycle management involves setting deprecation timelines and using tools like OpenAPI specification and API gateways to automate version management and detect breaking changes.

  3. 3
    Article
    Avatar of minersThe Miners·1y

    REST, RESTful APIs, and API documentation A dive-in on the most used architectural style to communicate between modern web applications!

    REST (Representational State Transfer) is an architectural style used for designing network-based applications, particularly web APIs. It provides a set of constraints that improve the scalability, performance, and manageability of software systems. RESTful APIs use standard HTTP methods for CRUD operations and ensure stateless communication, promoting separation of concerns. Key constraints include client-server architecture, uniform interface, statelessness, cacheability, layered system, and optional code-on-demand. Clear and consistent documentation is crucial, and tools like OpenApi and Swagger can help in documenting APIs effectively.

  4. 4
    Article
    Avatar of phProduct Hunt·1y

    RapidMCP - Convert your REST API into an MCP Server in minutes!

    RapidMCP allows the conversion of REST API specifications into MCP servers in minutes without any coding. It aims to streamline the process of making APIs MCP-ready, including considerations for OpenAPI Swagger spec and authentication.

  5. 5
    Article
    Avatar of freecodecampfreeCodeCamp·1y

    How to Work with OpenAPI in Go

    OpenAPI is a key standard for defining well-structured APIs in a language-agnostic manner. This guide explains how to architect, implement, and consume APIs using OpenAPI with Go. Covering everything from API design, schema components, and endpoint definitions, to generating server code and API documentation, this guide offers practical examples and tools for effective API management.

  6. 6
    Article
    Avatar of platformaticPlatformatic·38w

    Massimo: Type-Safe API Client generator

    Massimo is a type-safe API client generator that evolved from @platformatic/client, now supporting both OpenAPI and GraphQL schemas. It offers dual architecture with both code generation (massimo-cli) for build-time client creation and runtime library (massimo) for dynamic client generation. The tool generates TypeScript-first clients for both server-side (using Undici) and frontend (using native fetch) environments, with enterprise-grade features including authentication, validation, and telemetry support.

  7. 7
    Article
    Avatar of nordicapisNordic APIs·41w

    OpenAPI vs. TypeSpec: Which To Use?

    TypeSpec and OpenAPI serve complementary roles in API development rather than competing solutions. OpenAPI remains the mature, widely-adopted standard for describing RESTful APIs with extensive tooling support, while TypeSpec offers a TypeScript-like language for defining APIs that can generate OpenAPI specifications and other formats. TypeSpec excels at schema reuse, multi-format output, and large-scale governance through its code-first approach, but OpenAPI is better for quick handwritten specs and non-technical stakeholder collaboration. The choice depends on specific project needs, with TypeSpec acting as a design-time abstraction layer that can enhance OpenAPI workflows.

  8. 8
    Article
    Avatar of devblogsDevBlogs·28w

    OpenAPI.NET: The Biggest Update Ever

    Microsoft released OpenAPI.NET v2 and v3, the library's biggest updates since 2018. Version 2 adds OpenAPI 3.1 support with 50% faster parsing and 35% less memory usage through System.Text.Json integration. Version 3 introduces OpenAPI 3.2 support with enhanced media types, hierarchical tags, and extended parameter options. These updates impact major .NET tools like Swashbuckle, NSwag, and ASP.NET Core's native OpenAPI support in .NET 10.

  9. 9
    Article
    Avatar of awegoAwesome Go·1y

    gRPC API Gateway: Bridging the Gap Between REST and gRPC

    gRPC API Gateway facilitates the exposure of REST API endpoints for gRPC servers by providing enhanced configuration flexibility, modern OpenAPI support, comprehensive documentation, robust error handling, and extended streaming support. It improves upon the original gRPC Gateway with features like HTTP/JSON to gRPC translation, extensive control over API behavior, optimized OpenAPI 3.1 specifications, and seamless integration with contemporary API tools.

  10. 10
    Article
    Avatar of communityCommunity Picks·1y

    Unkey

    Zen is a lightweight HTTP framework built on Go's standard library, offering a clean developer experience, precise control over middleware, and seamless OpenAPI integration. It was created to overcome limitations found in existing frameworks, particularly around error handling, logging, and response capture. Zen follows a schema-first approach for OpenAPI, minimizes dependencies, and ensures handlers focus on business logic. It provides granular control over middleware execution, improving metrics, logging, and error responses while maintaining type safety without boilerplate.

  11. 11
    Article
    Avatar of logrocketLogRocket·24w

    tRPC vs oRPC: Which is better for your next TypeScript project, and why?

    tRPC and oRPC are both TypeScript RPC frameworks offering end-to-end type safety, but serve different needs. tRPC excels in TypeScript-only environments with minimal setup and instant type inference. oRPC extends this with built-in OpenAPI generation, enabling REST compatibility and multi-language support. The article provides hands-on demos of both frameworks, showing schema validation with Zod, type synchronization between client and server, and practical implementation patterns. Choose tRPC for internal TypeScript apps; choose oRPC when you need API documentation, external integrations, or polyglot team support.

  12. 12
    Article
    Avatar of atomicobjectAtomic Spin·28w

    I Used a Full Stack Workflow to Organize a Complex Storyboard

    A developer shares how they built a custom database-backed API to organize a complex creative writing project. The solution uses SQL for data storage, .NET for the API layer with a repository-service-controller pattern, Docker for database initialization, and OpenAPI Generator to create an NPM package for frontend integration. The project demonstrates applying professional full-stack development patterns to solve personal organizational challenges, taking approximately 30 hours from conception to completion.

  13. 13
    Video
    Avatar of communityCommunity Picks·1y

    NO SWAGGER? NO PROBLEM! OpenAPI Made Easy in .NET 9

    Starting with .NET 9, Swagger has been removed as the default OpenAPI package. The new approach involves using the Microsoft ASP.NET Core OpenAPI package to create OpenAPI documents. Various UI alternatives such as Swagger UI, Redoc, and Skaler can be integrated into the .NET 9 applications for better API documentation. Detailed guidance on setting up these UI options along with customizing command definitions for API services within .NET Aspire is provided.

  14. 14
    Article
    Avatar of foojayioFoojay.io·27w

    Document Your Spring REST APIs with Annotations

    Learn how to document Spring REST APIs using Swagger/OpenAPI annotations like @Tag, @Operation, @Parameter, @ApiResponse, and @Schema. These annotations keep API documentation synchronized with code, making endpoints self-documenting and easier to maintain. The guide includes practical examples of annotating controllers and DTOs, explains why documentation matters for team onboarding and client integrations, and provides a step-by-step approach to gradually adding documentation to existing APIs.

  15. 15
    Article
    Avatar of hnHacker News·1y

    coder/agentapi: HTTP API for Claude Code, Goose, Aider, and Codex

    AgentAPI allows users to control several coding agents including Claude Code, Goose, Aider, and Codex using an HTTP API. The API can be used to build unified chat interfaces, backend systems, or tools for submitting pull requests. The post provides installation instructions, sample commands, and information about the OpenAPI schema. It also details the structure of conversations handled by AgentAPI, including user and agent messages, and mentions future potential features.

  16. 16
    Article
    Avatar of itnextITNEXT·1y

    Practical OpenAPI in Go

    Learn about the OpenAPI Specification (OAS) and its importance in defining, implementing, and consuming APIs using the Go programming language. This guide covers the basics of OpenAPI, including setting up an API schema, defining paths and components, and generating server and client code. Practical examples and tips are provided, along with information on tools and best practices for working with OpenAPI.

  17. 17
    Article
    Avatar of infoqInfoQ·24w

    ASP.NET Core in .NET 10: Major Updates Across Blazor, APIs, and OpenAPI

    .NET 10 brings major updates to ASP.NET Core, including extensive Blazor enhancements (security samples, client-side fingerprinting, QuickGrid updates, improved routing), built-in validation for Minimal APIs, Server-Sent Events support, full OpenAPI 3.1 compatibility with improved schema generation, new authentication metrics, WebAuthn passkey support in Identity, Kestrel improvements, and a System.Text.Json-based JSON Patch implementation. The release also includes Hot Reload improvements, circuit state persistence, and expanded diagnostics capabilities.

  18. 18
    Article
    Avatar of devsquadDev Squad·1y

    🚀 Doks.io – Get your API documentation automatically

    Doks.io offers an automated approach to setting up API documentation through a simple middleware integration. It generates a live Swagger portal, ensuring performance with an asynchronous architecture and maintaining security by redacting and encrypting data at rest.

  19. 19
    Article
    Avatar of foojayioFoojay.io·45w

    Spring Boot documentation with Redocusaurus

    A step-by-step guide showing how to generate OpenAPI specifications from Spring Boot applications and create interactive API documentation using Redocusaurus, a Docusaurus plugin. Covers adding SpringDoc dependency, exporting API specs, setting up Redocusaurus with configuration, and deploying the resulting documentation site to various hosting platforms.

  20. 20
    Article
    Avatar of planetgolangPlanet Golang·50w

    Generating Go code from JSON Schema documents · Jamie Tanna

    Compares two popular Go libraries for generating struct types from JSON Schema documents: github.com/atombender/go-jsonschema (supports draft-07) and git.sr.ht/~emersion/go-jsonschema (supports 2020-12). The first generates individual named types with enum constants and comprehensive struct tags, while the second creates a single struct with anonymous nested types. Both tools can be integrated using go:generate directives, with tips provided for using $refs to create named types instead of anonymous ones.

  21. 21
    Article
    Avatar of devblogsDevBlogs·1y

    ASP.NET Core OData Web API Template Preview Release

    The ASP.NET Core OData Web API Template Pack public preview release is now available, designed for .NET 8.0 and above. This template simplifies creating ASP.NET Core Web API projects with OData support and offers features like OData query options, OpenAPI (Swagger) support, and case insensitive routing. Users can install the template via the dotnet CLI or Visual Studio IDE. Feedback is encouraged to improve this new release.

See all OpenAPI archives