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. We are a group of volunteers and starting a new scheme in our community. Your site offered us with useful information to paintings on. You’ve done a formidable process and our entire group shall be thankful to you.

  2. 캡사이트's avatar 캡사이트 says:

    Some genuinely excellent information, Gladiolus I discovered this. “Ideas control the world.” by James Abram Garfield.

  3. I needed to send you the little word just to say thank you once again for all the nice principles you have featured above. This has been simply surprisingly open-handed of you to give extensively all that many individuals would have marketed as an electronic book to help make some bucks on their own, notably now that you could have tried it if you ever wanted. Those good tips additionally served as a easy way to be certain that other people online have a similar fervor much like my very own to learn much more concerning this condition. I’m certain there are lots of more pleasant periods ahead for folks who see your blog.

  4. Very efficiently written article. It will be helpful to everyone who employess it, as well as myself. Keep up the good work – can’r wait to read more posts.

  5. kopitogel's avatar kopitogel says:

    Very interesting details you have mentioned, regards for posting. “The thing always happens that you really believe in and the belief in a thing makes it happen.” by Frank Lloyd Wright.

  6. I’ll right away clutch your rss as I can not to find your e-mail subscription link or e-newsletter service. Do you have any? Kindly permit me know so that I may just subscribe. Thanks.

  7. kopitogel's avatar kopitogel says:

    Way cool, some valid points! I appreciate you making this article available, the rest of the site is also high quality. Have a fun.

  8. situs togel's avatar situs togel says:

    Dead indited subject matter, Really enjoyed reading through.

  9. I am impressed with this website , rattling I am a fan.

  10. Sleep Lean is a natural supplement designed to improve sleep quality and aid weight loss while you sleep.

  11. toto's avatar toto says:

    Its wonderful as your other content : D, regards for putting up. “Experience is that marvelous thing that enables you to recognize a mistake when you make it again.” by Franklin P. Jones.

  12. dutamovie21's avatar dutamovie21 says:

    I’ve been surfing online more than three hours as of late, yet I never found any fascinating article like yours. It¦s lovely worth sufficient for me. In my opinion, if all webmasters and bloggers made just right content as you probably did, the web shall be much more useful than ever before.

  13. nextogel's avatar nextogel says:

    Aw, this was a very nice post. In idea I wish to put in writing like this moreover – taking time and precise effort to make a very good article… but what can I say… I procrastinate alot and certainly not appear to get something done.

  14. Lipovive acts on the metabolism, burning fat, reducing appetite, and providing more energy.

  15. I was looking through some of your articles on this site and I believe this site is rattling instructive! Retain putting up.

  16. nextogel's avatar nextogel says:

    Thank you so much for providing individuals with remarkably remarkable possiblity to read articles and blog posts from this site. It can be so brilliant and jam-packed with a great time for me personally and my office fellow workers to search your web site the equivalent of 3 times in a week to read the new stuff you have got. And of course, we are usually fascinated with the incredible suggestions you serve. Some 3 ideas in this posting are completely the finest I’ve ever had.

  17. You really make it seem really easy together with your presentation but I to find this topic to be actually something which I feel I’d never understand. It seems too complicated and very extensive for me. I am taking a look forward in your subsequent put up, I¦ll attempt to get the hold of it!

  18. The Pink Salt Trick is a minimalist but effective morning routine: Just drink a glass of lukewarm water mixed with a pinch of Himalayan pink salt as soon as you wake up.

  19. Thanks a bunch for sharing this with all of us you really recognise what you’re talking approximately! Bookmarked. Kindly additionally discuss with my website =). We may have a link change agreement between us!

  20. nextogel's avatar nextogel says:

    Undeniably believe that which you stated. Your favorite justification seemed to be on the internet the easiest thing to be aware of. I say to you, I certainly get irked while people think about worries that they plainly don’t know about. You managed to hit the nail upon the top and defined out the whole thing without having side-effects , people can take a signal. Will probably be back to get more. Thanks

  21. I am impressed with this web site, really I am a big fan .

  22. Woah! I’m really loving the template/theme of this website. It’s simple, yet effective. A lot of times it’s very difficult to get that “perfect balance” between user friendliness and visual appearance. I must say you’ve done a amazing job with this. Additionally, the blog loads very quick for me on Firefox. Superb Blog!

  23. The Pink Salt Trick is a minimalist but effective morning routine: Just drink a glass of lukewarm water mixed with a pinch of Himalayan pink salt as soon as you wake up.

  24. I?¦ve been exploring for a little for any high-quality articles or weblog posts in this sort of space . Exploring in Yahoo I ultimately stumbled upon this site. Reading this information So i am glad to exhibit that I have a very just right uncanny feeling I came upon exactly what I needed. I so much certainly will make sure to don?¦t omit this site and give it a look regularly.

  25. The Pink Salt Trick is a minimalist but effective morning routine: Just drink a glass of lukewarm water mixed with a pinch of Himalayan pink salt as soon as you wake up.

  26. oab 1a fase's avatar oab 1a fase says:

    Thank you for another wonderful article. Where else could anyone get that kind of information in such a perfect way of writing? I have a presentation next week, and I’m on the look for such information.

  27. Unquestionably believe that that you stated. Your favorite justification appeared to be at the web the simplest factor to take into account of. I say to you, I certainly get irked at the same time as folks consider concerns that they just do not recognize about. You controlled to hit the nail upon the highest and defined out the whole thing without having side-effects , folks could take a signal. Will probably be again to get more. Thanks

  28. The Pink Salt Trick is a minimalist but effective morning routine: Just drink a glass of lukewarm water mixed with a pinch of Himalayan pink salt as soon as you wake up.

  29. An interesting discussion is worth comment. I think that you should write more on this topic, it might not be a taboo subject but generally people are not enough to speak on such topics. To the next. Cheers

  30. This web site is my intake, real excellent style and design and perfect content.

  31. bandar togel's avatar bandar togel says:

    I have been absent for some time, but now I remember why I used to love this website. Thank you, I will try and check back more frequently. How frequently you update your website?

  32. so much wonderful info on here, : D.

  33. Pretty part of content. I just stumbled upon your weblog and in accession capital to assert that I acquire actually enjoyed account your blog posts. Anyway I will be subscribing to your feeds and even I achievement you get entry to constantly quickly.

  34. This is the suitable blog for anyone who needs to seek out out about this topic. You notice a lot its nearly hard to argue with you (not that I actually would need…HaHa). You positively put a new spin on a subject thats been written about for years. Great stuff, simply nice!

  35. hptoto's avatar hptoto says:

    I don’t even know how I ended up here, but I thought this post was good. I do not know who you are but definitely you’re going to a famous blogger if you are not already 😉 Cheers!

  36. Spot on with this write-up, I absolutely believe that this
    website needs much more attention. I’ll probably be back again to see more,
    thanks for the advice!

    Here is my page: burn flow weight loss reviews

  37. I’ve learn several good stuff here. Definitely worth bookmarking for revisiting. I wonder how so much attempt you place to make the sort of great informative web site. 印度神油心得

  38. 犀利士5mg's avatar 犀利士5mg says:

    I’ve learn several good stuff here. Definitely worth bookmarking for revisiting. I wonder how so much attempt you place to make the sort of great informative web site. 日本藤素官網

  39. It’s really a great and useful piece of info. I am glad that you shared this useful info with us. Please keep us up to date like this. Thanks for sharing.

  40. ADA ADAD's avatar ADA ADAD says:

    mk 官網哪裡買最便宜? 也深受年輕族群喜愛。小巧的外型搭配大容量設計,既能滿足日常需求,又能展現休閒時尚感。

  41. Very interesting details you have observed, thanks for putting up.

  42. paito hk's avatar paito hk says:

    Hey there! I’m at work browsing your blog from my new iphone 4! Just wanted to say I love reading through your blog and look forward to all your posts! Keep up the excellent work!

  43. Simply wanna remark on few general things, The website style and design is perfect, the content material is very excellent : D.

  44. I got what you mean ,bookmarked, very decent website .

  45. Pretty section of content. I just stumbled upon your site and in accession capital to assert that I acquire actually enjoyed account your blog posts. Any way I will be subscribing to your feeds and even I achievement you access consistently quickly.

  46. Hello. magnificent job. I did not expect this. This is a splendid story. Thanks!

  47. pestoto's avatar pestoto says:

    I’ve recently started a blog, the info you provide on this website has helped me tremendously. Thanks for all of your time & work. “So full of artless jealousy is guilt, It spills itself in fearing to be spilt.” by William Shakespeare.

  48. Hey, you used to write excellent, but the last few posts have been kinda boring… I miss your great writings. Past several posts are just a little bit out of track! come on!

  49. I’ve learn several good stuff here. Definitely worth bookmarking for revisiting. I wonder how so much attempt you place to make the sort of great informative web site.

Comments are closed.