Designing a Beautiful REST+JSON API

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


Join or login to comment.

  • Claire H.

    Hi All - The video and slides are now up on the Stormpath YouTube channel:

    October 2, 2012

  • Les H.

    Hi all,

    Thanks for the kudos - I enjoyed meeting so many people last night!

    Stormpath recorded the video and we'll have it online as soon as we can after editing. You can either subscribe to our blog ( or this Meetup thread to see when it is available.



    August 16, 2012

  • Sai

    Detailed presentation on REST + JSON

    August 16, 2012

  • A former member
    A former member

    good presentation

    August 16, 2012

  • A former member
    A former member

    Excellent presentation - very helpful.

    August 16, 2012

  • A former member
    A former member

    Excellent speaker, and very interesting presentation

    August 16, 2012

  • A former member
    A former member

    Very clear and very practical. I got a bunch of ideas on how to clean up our own API.

    August 16, 2012

  • Jim L.

    I agree with Kevin that this was one of the best JUG talks of the year. I base that statement on how much I learned.

    August 16, 2012

  • Sean S.

    Awesome presentation. Learned a lot.

    August 16, 2012

  • A former member
    A former member

    Good talk!

    August 16, 2012

  • Eli

    For me it was a waste of time (except for the pizza). The presenter had a captive audience of a couple of hundred developer (it seems) and squandered the opportunity to teach how to use the tools. He could have given an example of how to build a real, albeit small application from a to z. Instead he spent a lot of time on verbal abstract description without concrete examples. For instance he talked a lot about REST without even defining what it is, something which he could have done with one or two sentences. I was very disappointed.

    August 16, 2012

  • john s.

    great talk, I am glad it was recorded, hope the slides are available.
    Many helpful tips about REST+JSON that I otherwise would probably not learn.

    August 16, 2012

  • Rajan

    Excellent presentation and greatly orchestrated. Thanks Van for all the arrangements. Looking forward to next one

    August 16, 2012

  • Beilin Z.

    Good introduction on some best practices, very informative.

    August 16, 2012

  • Scott D.

    I was unable to break away from work to make this presentation ... will there be a webcast available ?

    August 16, 2012

  • Lukasz J.

    Great presenter

    August 16, 2012

  • Lee

    Excellent presentation. Thanks.

    August 15, 2012

  • Niley B.

    We are very happy to be at the Silicon Valley Java User Group today and being able to connect with the Mountain View community. Use the code SVJUG for $100 off @ QCon SF. Early birds can also register before August 24th and save an extra $500. Check out our website for more information about our conference. Thanks!

    August 15, 2012

  • lawrence

    For a limited time, get a free developer's ticket to GMIC-SV, a
    independent, cross-platform mobile conference in Silicon Valley

    Register at following link -

    Change quantity to 1 for Developer (Expo) line item
    click "Enter promotional code" and enter "HTML5" in box,
    click Apply button, then click Register button.

    August 15, 2012

  • Adarsh U

    Can waitlisted folks still show up? Any chance of being allowed in?

    August 15, 2012

  • Ankur S.

    Any chance of this being streamed or recorded?

    August 7, 2012

  • Suyash J.

    Already heard this talk in SF, I'm not wrong. Is this a repeat?

    August 3, 2012

    • A former member
      A former member

      Hi Lee - don't worry, I'm assuming no knowledge of previous presentations. I'm refining + cleaning up holes that were in the SFJUG presentation. Should be better this time!

      August 7, 2012

    • Les H.

      Hi Lee - don't worry, I'm assuming no knowledge of previous presentations. I'm refining + cleaning up holes that were in the SFJUG presentation. Should be better this time!

      August 7, 2012

  • Hari K.

    Want to know, what is patentable. Attend the meeting:

    August 7, 2012

Our Sponsors

  • Google

    Google provides the venue for most meetings.

  • New Relic

    New Relic, performance monitoring & analytics company, pays for pizza!

  • O'Reilly's OSCON

    SVJUG members can save 20% on any pass with discount code SVJUG

People in this
Meetup are also in:

Imagine having a community behind you

Get started Learn more

We just grab a coffee and speak French. Some people have been coming every week for months... it creates a kind of warmth to the group.

Rafaël, started French Conversation Group

Sign up

Meetup members, Log in

By clicking "Sign up" or "Sign up using Facebook", you confirm that you accept our Terms of Service & Privacy Policy