Couchbase uses Swagger to tame the API Monster, so should you

Couchbase incorporated Swagger into our documentation a few months ago. “Swagger” refers to an ecosystem of tools and other resources for managing REST APIs. Core to Swagger is the Swagger specification. (The group behind Swagger donated the spec to … more

My business card states my title as “Technology Evangelist”. I learn technology, use it in solutions to the point where I can teach it to others then I preach it.  My audience is mostly people who probably think I’m a little crazy.  When it comes to REST and API’s the answer I recommend now is using Swagger and its toolset to design, manage and document your valuable API’s.  I scream every time I see Word/Excel/Email documents beings used to define API’s in large systems.   Using 20th-century tools to manage modern 21st-century processes like API’s doesn’t scale and helps contribute to some of the failures I have seen.

via Managing REST APIs with Swagger (video) — JSFeeds

Dropbox does a Take 2 on their API

Dropbox builds a dramatically different V2 of their API, built for scale. By Margot Krouwer

Some important takeaways from this article concern using REST and the REST “Standards” as they may exist.  In creating V2 of the Dropbox API, however, Dropbox went decidedly out off trend. Rather than utilizing the paradigms of REST, or GraphQL or even socket servers, Dropbox created their own custom JSON in JSON out API which largely ignores the guidelines of REST or even HTTP.

via Evolving APIs for Scale with Dropbox — InfoQ