Update June 2014: Stormpath now secures authentication to your API—without code! Contact our sales team for more information!

Les recently gave a talk on “Designing a Beautiful REST + JSON API” at the San Francisco Java Users Group, which covers 18 months of his research into API design. This video on API design, includes a lengthy Q&A. The slides from the talk (below) contain code examples and references. For an example of these principles in action, check out our Product Documentation.

Interested in learning more about Ion? Review the draft specification.

The video includes API design best practices, including: 
  • REST + JSON API design
  • Base URL design tips
  • API security
  • Versioning for APIs
  • API resource formatting
  • API return values and content negotiation
  • API  references (linking)
  • API pagination, parameters, associations, and call errors
  • Method overloading, resource expansion, and partial responses
  • Caching and etags
  • Multi-tenancy
  • API versioning and maintenance