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. Hi, i read your blog from time to time and i own a similar one and i was just curious if you get a lot of spam feedback? If so how do you stop it, any plugin or anything you can suggest? I get so much lately it’s driving me insane so any assistance is very much appreciated.

  2. 9ph's avatar 9ph says:

    I’m not sure where you are getting your information, but great topic. I needs to spend some time learning more or understanding more. Thanks for great info I was looking for this info for my mission.

  3. phtaya's avatar phtaya says:

    I used to be suggested this web site by means of my cousin. I’m now not positive whether this submit is written by him as no one else recognize such detailed approximately my problem. You are amazing! Thanks!

  4. impermeabilizante's avatar impermeabilizante says:

    Just wanna comment that you have a very nice website , I love the style it really stands out.

  5. wonderful issues altogether, you simply received a logo new reader. What could you suggest about your submit that you simply made a few days ago? Any positive?

  6. c333 bet's avatar c333 bet says:

    I have not checked in here for a while because I thought it was getting boring, but the last few posts are good quality so I guess I will add you back to my daily bloglist. You deserve it my friend 🙂

  7. You are my inspiration , I own few web logs and often run out from to post .

  8. Very interesting details you have observed, appreciate it for putting up. “I don’t know what you could say about a day in which you have seen four beautiful sunsets.” by John Glenn.

  9. I was reading through some of your posts on this website and I believe this web site is very informative! Retain putting up.

  10. gtwinbet's avatar gtwinbet says:

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

  11. I just couldn’t depart your web site before suggesting that I extremely enjoyed the standard info a person provide for your visitors? Is gonna be back often in order to check up on new posts

  12. Hello. Great job. I did not imagine this. This is a impressive story. Thanks!

  13. Wohh precisely what I was searching for, thankyou for putting up.

  14. Just about all of whatever you claim happens to be supprisingly legitimate and it makes me wonder why I had not looked at this with this light previously. Your piece truly did switch the light on for me personally as far as this particular subject matter goes. Nevertheless at this time there is one particular issue I am not really too cozy with so while I try to reconcile that with the central theme of the point, permit me observe just what the rest of the visitors have to say.Well done.

  15. bplwin's avatar bplwin says:

    After examine a few of the blog posts in your website now, and I actually like your means of blogging. I bookmarked it to my bookmark website listing and might be checking again soon. Pls try my site as effectively and let me know what you think.

  16. I feel that is among the so much significant information for me. And i’m glad studying your article. But want to statement on some basic issues, The website style is wonderful, the articles is in point of fact excellent : D. Excellent task, cheers

  17. data macau's avatar data macau says:

    Hello! I could have sworn I’ve been to this blog before but after browsing through some of the post I realized it’s new to me. Anyways, I’m definitely happy I found it and I’ll be book-marking and checking back frequently!

  18. Thank you, I have just been looking for information about this subject for ages and yours is the best I have discovered so far. But, what about the conclusion? Are you sure about the source?

  19. Some truly interesting information, well written and loosely user pleasant.

  20. LhanepiliA's avatar LhanepiliA says:

    Excellent pieces. Keep posting such kind of information on your blog. Im really impressed by your site.
    Hi there, You’ve performed a great job. I will definitely digg it and personally suggest to my friends. I am confident they’ll be benefited from this site.
    https://winner188.com/melbet-2025-vebcity-obzor-bukmekera/

  21. I am no longer positive the place you’re getting your info, but good topic. I must spend some time studying more or figuring out more. Thanks for excellent info I used to be on the lookout for this info for my mission.

  22. Charlesspape's avatar Charlesspape says:

    Casino Roulette: Spin for the Ultimate Thrill
    Experience the timeless excitement of Casino Roulette, where every spin brings a chance to win big and feel the rush of luck. Try your hand at the wheel today at https://k8o.jp/ !

  23. certainly like your website but you need to take a look at the spelling on several of your posts. A number of them are rife with spelling problems and I find it very bothersome to tell the reality however I will surely come back again.

  24. I really appreciate this post. I?¦ve been looking all over for this! Thank goodness I found it on Bing. You’ve made my day! Thank you again

  25. I just couldn’t depart your web site prior to suggesting that I actually enjoyed the standard info a person provide for your visitors? Is going to be back often in order to check up on new posts

  26. Great wordpress blog here.. It’s hard to find quality writing like yours these days. I really appreciate people like you! take care

  27. slvip's avatar slvip says:

    I¦ve read a few just right stuff here. Certainly value bookmarking for revisiting. I surprise how so much attempt you place to make this sort of excellent informative website.

  28. Great article and right to the point. I don’t know if this is really the best place to ask but do you folks have any thoughts on where to get some professional writers? Thx 🙂

  29. Excellent website. Lots of useful info here. I am sending it to a few friends ans also sharing in delicious. And of course, thanks for your sweat!

  30. ughoki slot's avatar ughoki slot says:

    I have been exploring for a little bit for any high quality articles or blog posts on this kind of area . Exploring in Yahoo I at last stumbled upon this site. Reading this info So i’m happy to convey that I’ve a very good uncanny feeling I discovered exactly what I needed. I most certainly will make certain to do not forget this site and give it a look on a constant basis.

  31. ADA ADAD's avatar ADA ADAD says:

    relx電子菸
    逐步優化續航與穩定度,搭配多樣化煙彈,為使用者打造更自然且真實的霧化體驗。

  32. It is in reality a great and useful piece of info. I¦m satisfied that you just shared this helpful information with us. Please keep us up to date like this. Thank you for sharing.

  33. olxtoto's avatar olxtoto says:

    I envy your work, thankyou for all the interesting blog posts.

  34. bandar toto's avatar bandar toto says:

    of course like your web-site but you have to check the spelling on several of your posts. Many of them are rife with spelling issues and I find it very troublesome to tell the truth nevertheless I will definitely come back again.

  35. I do consider all the ideas you have introduced in your post. They’re very convincing and can definitely work. Nonetheless, the posts are too short for novices. May just you please extend them a bit from next time? Thanks for the post.

  36. togel's avatar togel says:

    There are some fascinating deadlines in this article but I don’t know if I see all of them middle to heart. There may be some validity however I’ll take hold opinion till I look into it further. Good article , thanks and we wish more! Added to FeedBurner as properly

  37. An impressive share, I just given this onto a colleague who was doing a little analysis on this. And he in fact bought me breakfast because I found it for him.. smile. So let me reword that: Thnx for the treat! But yeah Thnkx for spending the time to discuss this, I feel strongly about it and love reading more on this topic. If possible, as you become expertise, would you mind updating your blog with more details? It is highly helpful for me. Big thumb up for this blog post!

  38. Very interesting information!Perfect just what I was looking for!

  39. Rateio's avatar Rateio says:

    This really answered my problem, thank you!

  40. Prostavive's avatar Prostavive says:

    I like this post, enjoyed this one appreciate it for putting up.

  41. NathanTor's avatar NathanTor says:

    This website provides a lot of interesting and valuable information.
    On this platform, you can find many topics that help you learn new things.
    Users will appreciate the resources shared on this site.
    All topics is thoughtfully designed, making it convenient to use.
    The materials are presented professionally.
    You can find recommendations on different subjects.
    Whether you’re looking for educational content, this site has what you’re looking for.
    Overall, this website is a valuable hub for information seekers.
    https://technikcentral.de/

  42. NathanTor's avatar NathanTor says:

    This online platform contains a lot of engaging and informative information.
    On the website, you can find many topics that help you learn new things.
    Readers will enjoy the resources shared here.
    Every category is well-structured, making it simple to use.
    The articles are relevant and engaging.
    The site includes guides on various fields.
    Whether your interest is in useful facts, this site has a lot to offer.
    To sum up, this platform is a reliable place for people who enjoy discovering new things.
    https://pro-nrn.de/

  43. I believe other website owners should take this internet site as an model, very clean and fantastic user genial layout.

  44. Hello.This article was really interesting, especially since I was searching for thoughts on this topic last Thursday.

  45. Well I sincerely enjoyed studying it. This post procured by you is very useful for good planning.

  46. Very interesting information!Perfect just what I was searching for! “Water is the most neglected nutrient in your diet but one of the most vital.” by Kelly Barton.

  47. I want to voice my affection for your kind-heartedness supporting people who actually need guidance on this concern. Your special dedication to getting the solution across has been exceptionally insightful and have without exception enabled men and women much like me to reach their targets. Your helpful hints and tips signifies this much a person like me and far more to my office workers. Thanks a ton; from each one of us.

  48. I really like your writing style, great info, regards for posting :D. “Kennedy cooked the soup that Johnson had to eat.” by Konrad Adenauer.

  49. I am always thought about this, appreciate it for posting.

  50. toto's avatar toto says:

    Utterly pent content, thank you for information. “You can do very little with faith, but you can do nothing without it.” by Samuel Butler.

Comments are closed.