Past Meetup

Designing a Beautiful REST+JSON API

This Meetup is past

231 people went


6:00 - 7:00 Networking and Light Dinner

7:00 - 7:15 Welcome and Announcements

7:15 - 8:30 Presentation by Les Hazlewood

8:30 - 8:45 Q&A

Designing a really clean and intuitive REST + JSON API is no small feat. You have to worry about resources, collections of resources, pagination, query parameters, references to other resources, which HTTP Methods to use, HTTP Caching, security, and more! And you have to make sure it lasts and doesn't break clients as you add features over time. Further, while there are many references on creating REST APIs with XML, there are much fewer references for REST + JSON.

In this presentation, Les Hazlewood - Stormpath CTO and Apache Shiro PMC Chair - will share all of the golden nuggets learned while designing, implementing and supporting JSON-based REST APIs, using examples from a clean real-world REST+JSON API built with Java technologies. He will cover:

JSON-based data formats in a RESTful API References to other JSON-based resources (aka 'linking'). Resource collections and pagination How to map (and how not to map) HTTP methods to Resource CRUD Resource partial updates Supporting HTTP Method Overloading for clients that don't support HTTP PUT and DELETE API versioning strategies Meaningful Error responses Many-to-many resource relationships HTTP Caching and Optimistic concurrency control. Authentication and Security Les Hazlewood is co-founder and CTO of Stormpath and the Apache Shiro PMC Chair. Prior to forming Stormpath, he held senior architectural positions at Bloomberg and Delta Airlines and he was former CTO of a software engineering firm supporting educational and government agencies. Les has been actively involved in Open Source development for more than 10 years, committing or contributing to projects like the Spring Framework, JBoss, and of course Apache Shiro. Les has a BS in Computer Science from Georgia Tech, currently lives in San Mateo, CA and practices Kendo and studies Japanese when he's not banging out code.

Event Sponsors

Helping you Innovate, Share and Connect with free food and beer and one free conference pass for raffle.

GraphConnect 2012 is the first conference to focus on graph databases and the applications making sense of connected data. Come to GraphConnect, where hackers and practitioners gather to compare notes about pushing data in new, unthinkable directions, and showcase next gen applications. Innovate, share, connect. (

Location: Hyatt Regency Embarcadero, 5 Embarcadero Center

QCon San Francisco
News about the 2012 Conference, free food and beer and 3 passes to the conference for raffle.

QCon is a practitioner-driven conference designed for team leads, architects and project management. The program includes two tutorial days led by over 80 industry experts and authors and three conference days with 18 tracks and over 80 speakers covering a wide variety of relevant and exciting topics in software development today.

Location: Hyatt Regency Embarcadero, 5 Embarcadero Center

Tutorials: Nov 5-6 Conference: Nov 7-9