Mike Kistler (Microsoft) on OpenAPI

OpenAPI is the framework of choice for documenting APIs


OpenAPI support in ASP.NET Core API apps
https://learn.microsoft.com/en-us/aspnet/core/fundamentals/openapi/overview?view=aspnetcore-9.0
 
Generate OpenAPI documents at build-time
https://learn.microsoft.com/en-us/aspnet/core/fundamentals/openapi/aspnetcore-openapi?view=aspnetcore-9.0&tabs=visual-studio%2Cvisual-studio-code#generate-openapi-documents-at-build-time
 
The project file property to set the directory where the OpenAPI should be saved is “OpenApiDocumentsDirectory” and it is documented here:
https://learn.microsoft.com/en-us/aspnet/core/fundamentals/openapi/aspnetcore-openapi?view=aspnetcore-9.0&tabs=visual-studio%2Cvisual-studio-code#modifying-the-output-directory-of-the-generated-open-api-file
 
This section contains a summary of how C# types and attributes map to OpenAPI schemas.
https://learn.microsoft.com/en-us/aspnet/core/fundamentals/openapi/include-metadata?view=aspnetcore-9.0&tabs=minimal-apis#include-openapi-metadata-for-data-types
 
We talked about the OpenAPI specification — the latest version is here:
https://spec.openapis.org/oas/v3.1.1.html
 
I also briefly touched on the Overlay specification — that is here:
https://spec.openapis.org/overlay/v1.0.0.html
 
and the Arazzo Specification — that is here:
https://spec.openapis.org/arazzo/v1.0.1.html
 
The Roadmap for ASP.NET Core features in .NET 10 is here:
https://github.com/dotnet/aspnetcore/issues/59443

 

About Jesse Liberty

Jesse Liberty has three decades of experience writing and delivering software projects and is the author of 2 dozen books and a couple dozen online courses. His latest book, Building APIs with .NET, is now available wherever you buy your books. Liberty is a Senior SW Engineer for CNH and he was a Senior Technical Evangelist for Microsoft, a Distinguished Software Engineer for AT&T, a VP for Information Services for Citibank and a Software Architect for PBS. He is a Microsoft MVP.
This entry was posted in API and tagged . Bookmark the permalink.

51 Responses to Mike Kistler (Microsoft) on OpenAPI

  1. RobertErymn says:

    Discover the iconic Patek Philippe Nautilus, a luxury timepiece that blends sporty elegance with refined artistry.
    Introduced nearly 50 years ago, this legendary watch redefined high-end sports watches, featuring distinctive octagonal bezels and horizontally grooved dials .
    For stainless steel variants like the 5990/1A-011 with a 55-hour energy retention to opulent gold interpretations such as the 5811/1G-001 with a blue gradient dial , the Nautilus caters to both avid enthusiasts and everyday wearers .
    Used Patek Nautilus 5980 wristwatch
    The diamond-set 5719 elevate the design with gemstone accents, adding unmatched glamour to the timeless profile.
    According to recent indices like the 5726/1A-014 at ~$106,000, the Nautilus remains a coveted investment in the world of premium watchmaking.
    Whether you seek a vintage piece or modern redesign, the Nautilus embodies Patek Philippe’s legacy of excellence .

Leave a Reply

Your email address will not be published. Required fields are marked *