OpenAPI

Behind the scenes of the Nightscout API

March 1, 2023 Mar 1, 2023 03/1/23

Learn how to use TypeSpec to create an OpenAPI specification and Kiota to generate client libraries to integrate Nightscout (an open-source glucose monitor) with Microsoft Graph.

Describing a real API with Cadl: The Moostodon story

December 13, 2022 Dec 13, 2022 12/13/22

Mark W., Mike Kistler, Darrel Miller

Learn how Cadl and Kiota were used together to model the Mastodon API and generate a working Mastodon client.

The value of Cadl in designing APIs

December 13, 2022 Dec 13, 2022 12/13/22

Mike Kistler, Mark W.

This blog post describes the new Cadl API design language and its benefits for API authoring.

API Definitions as Developer Contracts

April 19, 2022 Apr 19, 2022 04/19/22

Mark W., Mike Kistler

APIs are our contracts with developers. This post will introduce you to how we approach defining and managing API definitions in Azure.

AutoRest and OpenAPI: The backbone of Azure SDK

November 6, 2020 Nov 6, 2020 11/6/20

David Wilson

Learn about the AutoRest code generation tool and how it converts OpenAPI specs to Azure SDKs in a variety of languages.

Azure SDK Blog

OpenAPI - Azure SDK Blog

Behind the scenes of the Nightscout API

Describing a real API with Cadl: The Moostodon story

The value of Cadl in designing APIs

API Definitions as Developer Contracts

AutoRest and OpenAPI: The backbone of Azure SDK