How To Design Intuitive RESTful JSON APIs

Les Hazlewood, CTO of Stormpath and PMC of Apache Shiro, gave a presentation to the Silicon Valley Java Users Group on designing intuitive RESTful JSON APIs. Using the Stormpath REST API, as an example, Hazlewood's hour long talk at the conference covers everything from fundamentals to designing clean APIs, focusing on resources, collections of resources, pagination, query parameters, correctly identifying HTTP request types, and more. The talk is a good introduction for developers intending on creating an API, and a good refresher with new tips for veteran developers. 



Be sure to read the next API Design article: How to Implement Smart UX Throughout API Design & Versioning

Original Article

REST+JSON API Design - Best Practices for Developers