‹/› Devsworld News

Devsworld Home

Microsoft Announces REST API Design Guidelines at All About The API Conference in Vegas

By Rich Tehrani
July 19, 2016

Gareth Smith, API Architect for Microsoft Graph, announced onstage at the All About the API Conference in Las Vegas today that the company just open-sourced its REST API Guidelines.

These guidelines represent a multi-year, cross-company, collaborative process aggregating the collective experience of hundreds of engineers designing, operating, and running global scale cloud services from across Microsoft; and listening to feedback on its APIs from customers and partners. 

The company has attempted to incorporate those learning’s along with industry best practices in the API space to create guidelines that API teams across Microsoft use on a daily basis. It also said it hopes as a result of releasing these guidelines that:

  • It will further stimulate feedback on its APIs and its approach to building them to better serve customers.
  • Since it has benefitted from others in the API design community who have shared their guidelines, it wants to contribute back. The company believes that organizations of almost any size building APIs can benefit from having their own design guidelines.  Many companies and even organizations such as the White House have already published their design guidelines and it’s their hope that by contributing theirs to the community conversation, they can add to the body of community knowledge and reusable content so that anyone can draw upon more collective knowledge when looking to a set standards and guidelines within their organization.

Customers really were at the heart of this decision and they were saying clearly:

  • It should be easier to get started with Microsoft APIs – Developers wanted to be able to run the curl tool against an API endpoint and get a human-readable result in just a few minutes.
  • APIs for Microsoft cloud services should be consistent – Developers didn’t care that an API to work with an Azure virtual machine and an API to work with a user’s Office 365 documents were developed by different parts of the company, they were both from Microsoft and developers expected consistency.

Smith discussed this during All About the API after talking about the company's new initiative, Microsoft Graph, which unifies the organizations disparate API strategy.

According to the company, The Microsoft REST API Guidelines, as a design principle, encourages application developers to have resources accessible to them via a RESTful HTTP interface. To provide the smoothest possible experience for developers on platforms following the Microsoft REST API Guidelines, REST APIs SHOULD follow consistent design guidelines to make using them easy and intuitive.

Smith also explained to attendees that Microsoft once focused only on business decision makers and developers. He said they now need to be drastically more inclusive - with a great API consumer experience which is much broader.

"Its not just developers but IT and ordinary end-users that need to use APIs," he said.

In addition citizen developers will grow as IT becomes more pervasive in the enterprise. Learn more from GitHub and Microsoft

Edited by Stefania Viscusi

Group Editor-in-Chief, TMC

Related Articles

Telecom API Market Set for Big Gains

By: Steve Anderson    3/24/2017

A rapidly increasing need for APIs and similar measures is expected to drive big gains in this market through 2021.

Read More

Flowroute to Discuss Common API Mistakes at All About the API

By: Alicia Young    2/8/2017

Doug Waller of Flowroute will be taking part in a panel at the All About The API event, collocated with ITEXPO, to discuss common mistakes that occur …

Read More

Wear Your Lifestyle with Google's Awareness API

By: Alicia Young    2/8/2017

Google has teamed up with H&M's digital fashion house Ivyrevel to use its Awareness API in a unique way. The duo wants to digitally design customized …

Read More

10 Trends that Will Impact Open-Source Technology

By: Special Guest    2/8/2017

Open source has become an integral piece of every developer's arsenal. The power of the community, the wisdom of many, and the ability to hook into va…

Read More

What the Google Hangouts API Shutdown Means

By: Special Guest    2/6/2017

Google's in an interesting place with Hangouts and chat with both the enterprise and the consumer. One thing is clear - what it's doing with Hangouts …

Read More