Over a million developers have joined DZone.
{{announcement.body}}
{{announcement.title}}

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

SnapLogic is the leading self-service enterprise-grade integration platform. Download the 2018 GartnerMagic Quadrant for Enterprise iPaaS or play around on the platform, risk free, for 30 days.

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.

With SnapLogic’s integration platform you can save millions of dollars, increase integrator productivity by 5X, and reduce integration time to value by 90%. Sign up for our risk-free 30-day trial!

Topics:
api ,api design ,google ,integration

Published at DZone with permission of

Opinions expressed by DZone contributors are their own.

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

{{ parent.tldr }}

{{ parent.urlSource.name }}