News

Microsoft Further Embraces OpenAPI Spec (formerly Swagger)

Microsoft has long embraced the OpenAPI Specification (formerly known as Swagger) for describing APIs, and it's now taking that support to the next level with a new online resource.

The company today announced the OpenAPI at Microsoft blog on its DevBlogs site, which is mostly devoted to the company's own products, along with open-source products and technologies that Microsoft uses or contributes to.

The OpenAPI Specification belongs in that latter category. It's developed under the direction of open-source champion The Linux Foundation, having been donated to the community in 2015 by SmartBear Software. It provides a formal standard for describing HTTP APIs to help devs understand how an API works, how a sequence of APIs work together, generate client code, create tests, apply design standards, and more.

OpenAPI
[Click on image for larger view.] OpenAPI (source: OpenAPI).

About that new blog, the inaugural offering reads: "While this is the first post here, Microsoft has a long relationship with the OpenAPI specification. Microsoft has been a member of the OpenAPI Initiative since its inception and is a key contributor. We have been using OpenAPI internally for years and have a wide range of products and tools that help our customers work with OpenAPI descriptions as part of their API development process."

The new blog will join existing documentation.

With the recent advent of advanced AI, the first post also showcases recent developments in that space affecting Microsoft's AI dev constructs, Semantic Kernel and Copilot Agents.

  • Semantic Kernel AI Applications: "If you are building AI infused applications, you may be interested in the Semantic Kernel support for plugins based on OpenAPI descriptions. You can use plugins to bring real time data from your APIs into your AI applications. If you have large OpenAPI descriptions and you only want to import a subset of that OpenAPI description there is API Manifest Plugins that can help you with that."

  • Copilot Agents: "Our recent announcements of Copilot Agents provides another opportunity to leverage OpenAPI descriptions. Copilot Agents are a new way to extend the capabilities of Microsoft 365 Copilot with access to any APIs you can describe."

Along with the Microsoft documentation about OpenAPI mentioned above, the project also published "What Is OpenAPI?" documentation that provides a general overview.

About the Author

David Ramel is an editor and writer at Converge 360.

comments powered by Disqus

Featured

  • Mastering Blazor Authentication and Authorization

    At the Visual Studio Live! @ Microsoft HQ developer conference set for August, Rockford Lhotka will explain the ins and outs of authentication across Blazor Server, WebAssembly, and .NET MAUI Hybrid apps, and show how to use identity and claims to customize application behavior through fine-grained authorization.

  • Linear Support Vector Regression from Scratch Using C# with Evolutionary Training

    Dr. James McCaffrey from Microsoft Research presents a complete end-to-end demonstration of the linear support vector regression (linear SVR) technique, where the goal is to predict a single numeric value. A linear SVR model uses an unusual error/loss function and cannot be trained using standard simple techniques, and so evolutionary optimization training is used.

  • Low-Code Report Says AI Will Enhance, Not Replace DIY Dev Tools

    Along with replacing software developers and possibly killing humanity, advanced AI is seen by many as a death knell for the do-it-yourself, low-code/no-code tooling industry, but a new report belies that notion.

  • Vibe Coding with Latest Visual Studio Preview

    Microsoft's latest Visual Studio preview facilitates "vibe coding," where developers mainly use GitHub Copilot AI to do all the programming in accordance with spoken or typed instructions.

  • Steve Sanderson Previews AI App Dev: Small Models, Agents and a Blazor Voice Assistant

    Blazor creator Steve Sanderson presented a keynote at the recent NDC London 2025 conference where he previewed the future of .NET application development with smaller AI models and autonomous agents, along with showcasing a new Blazor voice assistant project demonstrating cutting-edge functionality.

Subscribe on YouTube