REST - Azure SDK Blog

Azure’s approach to versioning and avoiding breaking changes

March 6, 2023 Mar 6, 2023 03/6/23

Mike Kistler, Jeffrey Richter

Learn about the philosophy of Azure versioning and the process and tools we use to avoid breaking changes.

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.

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

June 28, 2022 Jun 28, 2022 06/28/22

Mark W., Mike Kistler

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

Azure REST API Guidelines Update

October 5, 2021 Oct 5, 2021 10/5/21

Mark W., Mike Kistler

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.