Mark W.

Principal Architect, Developer Division

Post by this author

Behind the scenes of the Nightscout API

March 1st, 2023
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 13th, 2022
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 13th, 2022
This blog post describes the new Cadl API design language and its benefits for API authoring.

It just takes time. Updated guidance on Azure long-running operations.

June 28th, 2022
Developers hate waiting, but sometimes it's necessary. When we know something is going to take time in Azure, it's modeled as a long-running operation (LRO). We've recently updated our guidance on LROs in our REST API guidelines.

API Definitions as Developer Contracts

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

Azure REST API Guidelines Update

October 5th, 2021
Providing APIs that are easy to use, fit to purpose, scalable, maintainable, and consistent make the difference between success and failure for your software. The guidelines help Microsoft engineering teams, and others building REST services, create APIs that are approachable, sustainable, and consistent.