Over a million developers have joined DZone.

Google Shares Their API Design Guide

DZone's Guide to

Google Shares Their API Design Guide

The noteworthy Google API design guide has a goal of helping developers design simple, consistent, and easy-to-use networked APIs.

· Integration Zone
Free Resource

Share, secure, distribute, control, and monetize your APIs with the platform built with performance, time-to-value, and growth in mind. Free 90-day trial of 3Scale by Red Hat

Google released an API design guide recently. I'll be adding the design guide to the list of examples I have in my API design research. The Google API design guide is pretty straightforward in its purpose, with a goal of helping "developers design simple, consistent, and easy-to-use networked APIs" — but I thought it was noteworthy that they were also looking to help "converging designs of socket-based RPC APIs with HTTP-based REST APIs."

Image title

gRPC and Protocol Buffers have been on my task list to learn more about for a while now, but without any projects at scale, it's probably not a task I'll find much time for anytime soon. I'll try to carve off more time to learn how folks like Google are doing it through their guides and storytelling. One thing I did know, which Google reinforces, is that "many companies use socket-based RPC APIs to carry most network traffic, which can be orders of magnitude higher than public REST APIs."

I like their approach that "both RPC APIs and HTTP REST APIs are needed for various reasons. Ideally, an API platform should provide the best support for all APIs." They also note the following:

"This Design Guide explains how to apply REST principles to API designs independent of programming language, operating system, or network protocol. It is NOT a guide solely to creating REST APIs."

I like this because we are getting past the notion that API design is simply about REST--it is clearly evolving to be more about getting the work done than any single philosophy or dogma.

In addition to encouraging more API providers to craft an API design guide for their companies using API Stylebook and to share their API design guides with the public, I will also be encouraging companies to think beyond just REST when they consider their API design best practices. I'm hoping that more companies will continue to do the hard work of getting their API design house in order because that means they can also begin to think about best practices when it comes to API deployment, management, testing, and the other stops along the API lifecycle.

Explore the core elements of owning an API strategy and best practices for effective API programs. Download the API Owner's Manual, brought to you by 3Scale by Red Hat

api ,api design ,google ,integration

Published at DZone with permission of Kin Lane, DZone MVB. See the original article here.

Opinions expressed by DZone contributors are their own.


Dev Resources & Solutions Straight to Your Inbox

Thanks for subscribing!

Awesome! Check your inbox to verify your email so you can start receiving the latest in tech news and resources.


{{ parent.title || parent.header.title}}

{{ parent.tldr }}

{{ parent.urlSource.name }}