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. Pretty great post. I simply stumbled upon your weblog and wanted to say that I’ve truly loved browsing your blog posts. After all I’ll be subscribing for your feed and I am hoping you write again very soon!

  2. akongcuan's avatar akongcuan says:

    Hiya, I am really glad I have found this information. Nowadays bloggers publish only about gossips and net and this is really irritating. A good site with exciting content, that is what I need. Thanks for keeping this website, I will be visiting it. Do you do newsletters? Can’t find it.

  3. I have recently started a web site, the information you offer on this website has helped me greatly. Thanks for all of your time & work.

  4. Scottnig's avatar Scottnig says:

    Выбор специалиста — важный шаг на пути к укреплению эмоционального здоровья.
    Для начала стоит уточнить свои потребности и запросы от консультации с профессионалом.
    Хорошо ознакомиться с подготовку и опыт психолога.
    Комментарии прошлых обратившихся могут помочь сделать решение более осознанным.
    Также нужно проверить техники, которыми пользуется психолог.
    https://studyinassam.com/%D0%BE%D0%BD%D0%BB%D0%B0%D0%B9%D0%BD-%D0%BF%D1%81%D0%B8%D1%85%D0%B8%D0%B0%D1%82%D1%80-%D0%BA%D0%BE%D0%BD%D1%81%D1%83%D0%BB%D1%8C%D1%82%D0%B0%D1%86%D0%B8%D0%B8-%D0%B4%D0%BB%D1%8F-%D0%B2%D0%B0%D1%88/
    Начальная встреча поможет оценить, насколько подходит стиль общения.
    Важно помнить тариф и формат работы (например, очно).
    Взвешенный выбор психолога поможет сделать эффективнее движение к целям.

  5. Scottnig's avatar Scottnig says:

    Поиск консультанта — важный этап на пути к улучшению эмоционального здоровья.
    Для начала стоит понять свои потребности и пожелания от работы с профессионалом.
    Полезно ознакомиться с образование и практику специалиста.
    Отзывы бывших клиентов могут подсказать сделать оценку более уверенным.
    Также обратите внимание подходы, которыми работает специалист.
    https://vin-de-pays-charente.com/%D1%8D%D1%84%D1%84%D0%B5%D0%BA%D1%82%D0%B8%D0%B2%D0%BD%D0%BE%D0%B5-%D0%BB%D0%B5%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D1%83-%D0%B2%D1%80%D0%B0%D1%87%D0%B0-%D0%BF%D1%81%D0%B8%D1%85%D0%B8%D0%B0%D1%82%D1%80/
    Стартовая сессия поможет понять, насколько есть доверие общения.
    Важно учитывать стоимость и способ работы (например, удалённо).
    Осознанный выбор профессионала позволит улучшить личный рост.

  6. ADA ADAD's avatar ADA ADAD says:

    mk 官網哪裡買最便宜?,無論是經典包款還是最新系列,都能感受到品牌獨特的現代美學

  7. We are a group of volunteers and opening a brand new scheme in our community. Your site offered us with helpful information to paintings on. You have performed an impressive activity and our whole group will likely be grateful to you.

  8. alexa138's avatar alexa138 says:

    I’m still learning from you, but I’m trying to achieve my goals. I absolutely liked reading all that is written on your website.Keep the aarticles coming. I loved it!

  9. he blog was how do i say it… relevant, finally something that helped me. Thanks

  10. Scottnig's avatar Scottnig says:

    Выбор психолога — важный процесс на пути к поддержанию эмоционального здоровья.
    Прежде всего стоит определить свои задачи и ожидания от работы с профессионалом.
    Важно проверить образование и опыт консультанта.
    Комментарии прошлых пациентов могут помочь сделать оценку более уверенным.
    Также следует учитывать техники, которыми оперирует консультант.
    https://lwc-london.com/%D1%86%D0%B5%D0%BD%D1%82%D1%80-%D1%8D%D0%BC%D0%BF%D0%B0%D1%82%D0%B8%D1%8F-%D0%BE%D0%BF%D1%8B%D1%82%D0%BD%D1%8B%D0%B9-%D0%BF%D1%81%D0%B8%D1%85%D0%B8%D0%B0%D1%82%D1%80-%D1%80%D1%8F%D0%B4%D0%BE/
    Начальная сессия поможет оценить, насколько подходит стиль общения.
    Необходимо осознавать тариф и режим работы (например, онлайн).
    Взвешенный выбор профессионала способен сделать эффективнее процесс изменений.

  11. Scottnig's avatar Scottnig says:

    Выбор специалиста — серьёзный этап на пути к поддержанию эмоционального здоровья.
    Прежде всего стоит определить свои цели и запросы от сотрудничества с профессионалом.
    Важно изучить образование и специализацию специалиста.
    Рекомендации бывших пациентов могут подсказать сделать решение более обоснованным.
    Также следует учитывать методы, которыми работает специалист.
    https://midigitaludyojak.com/%D0%BF%D0%BE%D1%87%D0%B5%D0%BC%D1%83-%D0%B2%D0%B0%D0%B6%D0%BD%D0%BE-%D0%B4%D0%BE%D0%B2%D0%B5%D1%80%D1%8F%D1%82%D1%8C-%D0%B2%D1%80%D0%B0%D1%87%D1%83-%D0%BF%D1%81%D0%B8%D1%85%D0%B8%D0%B0%D1%82%D1%80/
    Стартовая сессия поможет понять, насколько есть доверие общения.
    Важно учитывать цену и способ работы (например, очно).
    Взвешенный выбор специалиста позволит улучшить процесс изменений.

  12. I really appreciate this post. I have been looking everywhere for this! Thank goodness I found it on Bing. You have made my day! Thx again

  13. togel sgp's avatar togel sgp says:

    Appreciate it for this marvellous post, I am glad I observed this site on yahoo.

  14. Appreciate it for helping out, fantastic information.

  15. Danielerubs's avatar Danielerubs says:

    Поиск консультанта — серьёзный этап на пути к поддержанию эмоционального здоровья.
    Сначала стоит уточнить свои потребности и запросы от работы с экспертом.
    Хорошо ознакомиться с квалификацию и практику консультанта.
    Рекомендации бывших пациентов могут поспособствовать сделать решение более уверенным.
    Также следует учитывать техники, которыми оперирует психолог.
    https://petcleanshop.com/%D0%BF%D1%81%D0%B8%D1%85%D0%B8%D0%B0%D1%82%D1%80-%D0%BF%D0%BE%D0%BC%D0%BE%D0%B6%D0%B5%D1%82-%D1%81%D0%BF%D1%80%D0%B0%D0%B2%D0%B8%D1%82%D1%8C%D1%81%D1%8F-%D1%81-%D1%82%D1%80%D0%B5%D0%B2%D0%BE%D0%B3/
    Стартовая консультация поможет оценить, насколько подходит стиль общения.
    Следует учитывать цену и формат работы (например, очно).
    Правильный выбор специалиста позволит улучшить движение к целям.

  16. Danielerubs's avatar Danielerubs says:

    Выбор консультанта — ответственный процесс на пути к улучшению эмоционального здоровья.
    Для начала стоит понять свои задачи и запросы от консультации с экспертом.
    Важно изучить подготовку и опыт специалиста.
    Комментарии прошлых обратившихся могут помочь сделать оценку более осознанным.
    Также нужно проверить подходы, которыми оперирует консультант.
    https://medicalmalpracticedoctorlawyer.com/%D1%81%D0%BE%D0%B2%D1%80%D0%B5%D0%BC%D0%B5%D0%BD%D0%BD%D1%8B%D0%B5-%D0%BC%D0%B5%D1%82%D0%BE%D0%B4%D1%8B-%D0%BB%D0%B5%D1%87%D0%B5%D0%BD%D0%B8%D1%8F-%D0%BA%D0%BE%D1%82%D0%BE%D1%80%D1%8B%D0%B5-%D0%BF/
    Начальная встреча поможет почувствовать, насколько есть доверие общения.
    Важно помнить цену и формат сотрудничества (например, удалённо).
    Осознанный выбор психолога поможет сделать эффективнее личный рост.

  17. toto togel's avatar toto togel says:

    With the whole thing which seems to be building throughout this particular subject matter, many of your opinions are somewhat exciting. On the other hand, I appologize, because I do not subscribe to your whole idea, all be it exciting none the less. It looks to us that your opinions are generally not completely rationalized and in reality you are yourself not entirely convinced of the point. In any case I did appreciate looking at it.

  18. Some genuinely excellent blog posts on this website , thankyou for contribution.

  19. 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.

  20. Hello, Neat post. There’s a problem together with your web site in internet explorer, could test thisK IE nonetheless is the market chief and a huge component of people will pass over your great writing because of this problem.

  21. Hey very nice web site!! Man .. Beautiful .. Amazing .. I’ll bookmark your blog and take the feeds also…I’m happy to find numerous useful information here in the post, we need work out more techniques in this regard, thanks for sharing. . . . . .

  22. 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.

  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 got what you mean , appreciate it for putting up.Woh I am delighted to find this website through google.

  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. 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.

  27. pestoto's avatar pestoto says:

    I discovered your weblog site on google and check a number of of your early posts. Proceed to keep up the very good operate. I just further up your RSS feed to my MSN Information Reader. Looking for ahead to studying extra from you later on!…

  28. Only wanna comment on few general things, The website pattern is perfect, the written content is real great. “Taxation WITH representation ain’t so hot either.” by Gerald Barzan.

  29. Excellent website. A lot of useful info here. I am sending it to several pals ans additionally sharing in delicious. And obviously, thanks on your effort!

  30. There may be noticeably a bundle to find out about this. I assume you made sure good factors in features also.

  31. I like what you guys are up also. Such clever work and reporting! Carry on the excellent works guys I have incorporated you guys to my blogroll. I think it’ll improve the value of my website 🙂

  32. pestoto's avatar pestoto says:

    Some genuinely interesting information, well written and broadly user genial.

  33. nextogel's avatar nextogel says:

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

  34. You have brought up a very wonderful details, thankyou for the post.

  35. nextogel's avatar nextogel says:

    I?¦m no longer certain the place you are getting your info, however good topic. I needs to spend some time studying more or working out more. Thanks for magnificent information I was looking for this info for my mission.

  36. slot gacor's avatar slot gacor says:

    I’ll immediately seize your rss feed as I can not to find your e-mail subscription hyperlink or newsletter service. Do you’ve any? Kindly allow me understand in order that I may subscribe. Thanks.

  37. Some times its a pain in the ass to read what people wrote but this website is very user pleasant! .

  38. It?¦s really a cool and useful piece of information. I?¦m happy that you simply shared this helpful information with us. Please stay us up to date like this. Thank you for sharing.

  39. It¦s really a nice and useful piece of information. I am glad that you just shared this helpful information with us. Please stay us up to date like this. Thank you for sharing.

  40. Hmm is anyone else having problems with the pictures on this blog loading? I’m trying to figure out if its a problem on my end or if it’s the blog. Any responses would be greatly appreciated.

  41. Very interesting info !Perfect just what I was searching for!

  42. Thank you for the good writeup. It in fact was a amusement account it. Look advanced to more added agreeable from you! However, how could we communicate?

  43. ADA ADAD's avatar ADA ADAD says:

    mk 官網哪裡買最便宜? 因為輕巧、百搭且設計簡約,一直是品牌最熱銷的系列之一。它的優點包括:

  44. airmatic's avatar airmatic says:

    Great blog here! Also your web site loads up very fast! What host are you using? Can I get your affiliate link to your host? I wish my web site loaded up as fast as yours lol

  45. oma333's avatar oma333 says:

    Some truly great content on this site, appreciate it for contribution. “Better shun the bait, than struggle in the snare.” by John Dryden.

  46. Hello.This post was extremely remarkable, particularly because I was investigating for thoughts on this matter last Thursday.

  47. Hello my loved one! I wish to say that this article is awesome, great written and come with almost all significant infos. I would like to see more posts like this.

  48. indocair's avatar indocair says:

    I got what you intend, regards for posting.Woh I am glad to find this website through google. “The test and use of a man’s education is that he finds pleasure in the exercise of his mind.” by Carl Barzun.

  49. The innovative LED display provides real-time feedback on brushing mode, timer, and battery status. Crafted from sleek, waterproof materials with a wireless charging glass杯, imask offers multiple brushing modes and weeks of use on a single charge. More than a toothbrush, it’s a statement of luxury and cutting-edge technology, designed for those who demand the very best for their oral health.

Comments are closed.