OpenAPI.NET with Darrel Miller
How do you make sure your APIs can interop across languages and other complexities? Carl and Richard talk to Darrel Miller about OpenAPI, the open source specification for standard aspects of APIs like collections, security rules and more. The specification is now at version 3 and starting to really mature - all the big players are involved, and you can contribute as well! Darrel discusses how Microsoft has been implementing OpenAPI standards to their own APIs and what it takes for you to do it as well. There is an OpenAPI.NET implementation available at GitHub for you to work from and lots of great information in Microsoft docs. Check it out!
Guests:
Darrel Miller
Darrel is a software developer at Microsoft working for the Azure API Management team. He has been building distributed business applications on the Microsoft platform for more than 20 years. He is an active member of the .NET community and OSS contributor. He is a member of the OAI Technical Steering Committee, working on the next version of the OpenAPI specification and recently joined the Microsoft OneAPI Council, who are responsible for providing API design guidelines within Microsoft and to the Microsoft ecosystem. He co-authored the O'Reilly book, Designing Evolvable Web APIs with ASP.NET.
Links:
- import.io https://www.import.io/
- Azure API Management https://azure.microsoft.com/en-ca/services/api-management/
- Swagger https://swagger.io/
- Open API https://www.openapis.org/
- OData http://www.odata.org/
- APIs.json http://apisjson.org/
- AsyncAPI https://www.asyncapi.com/
- OpenAPI in Microsoft Docs https://docs.microsoft.com/en-us/azure/azure-functions/functions-openapi-definition
- OpenAPI.NET on GitHub https://github.com/Microsoft/OpenAPI.NET