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

 

Unknown's avatar

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. Liberty is a Senior AI Engineer at the University of Pittsburgh Medical Center, and was a Team Lead and Senior Software Engineer for various corporations, 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 21 year Microsoft MVP.
This entry was posted in API and tagged . Bookmark the permalink.

2,935 Responses to Mike Kistler (Microsoft) on OpenAPI

  1. I?¦ll immediately snatch your rss as I can’t in finding your email subscription hyperlink or e-newsletter service. Do you’ve any? Please allow me recognize so that I could subscribe. Thanks.

  2. You made some respectable factors there. I seemed on the internet for the difficulty and found most people will go together with together with your website.

  3. Right now it appears like WordPress is the preferred blogging platform out there right now. (from what I’ve read) Is that what you are using on your blog?

  4. Please let me know if you’re looking for a writer for your weblog. You have some really great posts and I think I would be a good asset. If you ever want to take some of the load off, I’d really like to write some articles for your blog in exchange for a link back to mine. Please send me an email if interested. Thanks!

  5. It is the best time to make a few plans for the future and it is time to be happy. I’ve learn this publish and if I may just I want to recommend you few fascinating things or advice. Maybe you can write next articles regarding this article. I wish to learn more issues about it!

  6. I’d have to examine with you here. Which is not one thing I usually do! I take pleasure in reading a post that may make folks think. Additionally, thanks for permitting me to comment!

  7. It’s appropriate time to make some plans for the long run and it’s time to be happy. I’ve learn this submit and if I could I wish to recommend you some fascinating things or tips. Perhaps you can write next articles relating to this article. I want to learn even more issues approximately it!

  8. I just could not depart your site prior to suggesting that I extremely loved the standard information an individual provide on your visitors? Is gonna be back continuously in order to check up on new posts.

  9. I think other website proprietors should take this website as an model, very clean and superb user pleasant style.

  10. I genuinely enjoy examining on this website, it has wonderful blog posts. “Beware lest in your anxiety to avoid war you obtain a master.” by Demosthenes.

  11. Fantastic items from you, man. I have keep in mind your stuff prior to and you are simply extremely great. I actually like what you have obtained here, certainly like what you’re stating and the way by which you are saying it. You are making it entertaining and you still care for to keep it smart. I can’t wait to read much more from you. This is actually a tremendous website.

  12. onewave's avatar onewave says:

    Great – I should certainly pronounce, impressed with your site. I had no trouble navigating through all tabs and related information ended up being truly easy to do to access. I recently found what I hoped for before you know it in the least. Reasonably unusual. Is likely to appreciate it for those who add forums or anything, site theme . a tones way for your client to communicate. Excellent task.

  13. You can certainly see your expertise within the work you write. The arena hopes for even more passionate writers such as you who are not afraid to say how they believe. Always follow your heart.

  14. I loved as much as you will receive carried out right here. The sketch is tasteful, your authored material stylish. nonetheless, you command get got an impatience over that you wish be delivering the following. unwell unquestionably come more formerly again since exactly the same nearly very often inside case you shield this increase.

  15. Howdy! This is kind of off topic but I need some help from an established blog. Is it very difficult to set up your own blog? I’m not very techincal but I can figure things out pretty quick. I’m thinking about making my own but I’m not sure where to begin. Do you have any ideas or suggestions? With thanks

  16. Thanks for a marvelous posting! I quite enjoyed reading it, you could be a great author.I will remember to bookmark your blog and will come back at some point. I want to encourage continue your great writing, have a nice weekend!

  17. I’ve recently started a web site, the info you offer on this website has helped me tremendously. Thanks for all of your time & work.

  18. Hi, Neat post. There’s a problem with your site in internet explorer, would test this… IE still is the market leader and a huge portion of people will miss your excellent writing due to this problem.

  19. Great V I should definitely pronounce, impressed with your web site. I had no trouble navigating through all the tabs as well as related information ended up being truly easy to do to access. I recently found what I hoped for before you know it at all. Reasonably unusual. Is likely to appreciate it for those who add forums or something, web site theme . a tones way for your customer to communicate. Nice task..

  20. Hello, you used to write excellent, but the last several posts have been kinda boring?K I miss your super writings. Past few posts are just a little out of track! come on!

  21. I really enjoy studying on this internet site, it has got great posts.

  22. I’m still learning from you, while I’m improving myself. I definitely liked reading all that is written on your website.Keep the stories coming. I liked it!

  23. 21 game's avatar 21 game says:

    Pretty section of content. I just stumbled upon your blog and in accession capital to assert that I acquire actually enjoyed account your blog posts. Anyway I’ll be subscribing to your feeds and even I achievement you access consistently rapidly.

  24. Auto Screen's avatar Auto Screen says:

    I am glad to be a visitant of this arrant site! , regards for this rare information! .

  25. Good day! This post could not be written any better! Reading this post reminds me of my previous room mate! He always kept talking about this. I will forward this article to him. Pretty sure he will have a good read. Thank you for sharing!

  26. There’s noticeably a bundle to know about this. I assume you made certain nice points in features also.

  27. Very good blog! Do you have any recommendations for aspiring writers? I’m hoping to start my own website soon but I’m a little lost on everything. Would you suggest starting with a free platform like WordPress or go for a paid option? There are so many choices out there that I’m totally confused .. Any suggestions? Cheers!

  28. I got what you mean , appreciate it for posting.Woh I am lucky to find this website through google. “Delay is preferable to error.” by Thomas Jefferson.

  29. Thank you for another informative blog. The place else may just I get that type of information written in such an ideal method? I’ve a mission that I’m just now working on, and I’ve been on the glance out for such info.

  30. pestoto's avatar pestoto says:

    Greetings! Quick question that’s completely off topic. Do you know how to make your site mobile friendly? My web site looks weird when viewing from my iphone4. I’m trying to find a template or plugin that might be able to fix this problem. If you have any recommendations, please share. Thanks!

  31. akongcuan's avatar akongcuan says:

    My brother recommended I might like this blog. He was entirely right. This post actually made my day. You can not imagine just how much time I had spent for this information! Thanks!

  32. very good publish, i definitely love this website, carry on it

  33. Just what I was searching for, thanks for putting up.

  34. Thankyou for this post, I am a big big fan of this internet site would like to go along updated.

  35. togel online's avatar togel online says:

    There is noticeably a bundle to know about this. I assume you made certain nice points in features also.

  36. japritoto's avatar japritoto says:

    Very informative and wonderful bodily structure of subject material, now that’s user friendly (:.

  37. live macau's avatar live macau says:

    Hello, i think that i saw you visited my weblog so i came to “return the favor”.I am attempting to find things to improve my website!I suppose its ok to use a few of your ideas!!

  38. olxtoto's avatar olxtoto says:

    Thanks so much for providing individuals with a very special opportunity to read critical reviews from this blog. It is often so kind and full of a great time for me and my office fellow workers to visit your site no less than thrice weekly to learn the newest tips you will have. And indeed, I am also actually astounded with the fabulous tactics you give. Selected 4 ideas on this page are absolutely the finest I’ve had.

  39. Do you have a spam problem on this site; I also am a blogger, and I was wondering your situation; we have developed some nice practices and we are looking to trade techniques with others, why not shoot me an email if interested.

  40. Hello, i think that i saw you visited my weblog so i came to “return the favor”.I’m trying to find things to improve my site!I suppose its ok to use some of your ideas!!

  41. olxtoto's avatar olxtoto says:

    Everything is very open and very clear explanation of issues. was truly information. Your website is very useful. Thanks for sharing.

  42. roro's avatar roro says:

    Very interesting topic, thanks for posting.

  43. Pretty nice post. I just stumbled upon your blog and wished to say that I have really enjoyed surfing around your blog posts. After all I’ll be subscribing to your rss feed and I hope you write again very soon!

  44. slot gacor's avatar slot gacor says:

    I enjoy the efforts you have put in this, thanks for all the great posts.

  45. paito macau's avatar paito macau says:

    I will right away seize your rss feed as I can not to find your e-mail subscription hyperlink or e-newsletter service. Do you have any? Please let me recognize in order that I may just subscribe. Thanks.

  46. Wow! Thank you! I always needed to write on my blog something like that. Can I implement a portion of your post to my blog?

  47. Very good website you have here but I was wondering if you knew of any message boards that cover the same topics talked about here? I’d really love to be a part of community where I can get feed-back from other experienced individuals that share the same interest. If you have any suggestions, please let me know. Kudos!

  48. hk togel's avatar hk togel says:

    Lovely just what I was searching for.Thanks to the author for taking his clock time on this one.

  49. slot gacor's avatar slot gacor says:

    Generally I do not read post on blogs, but I would like to say that this write-up very forced me to try and do so! Your writing style has been amazed me. Thanks, very nice post.

Comments are closed.