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. 



Original Article

REST+JSON API Design - Best Practices for Developers

Bill Doerrfeld I am a consultant that specializes in API economy research & content creation for developer-centric programs. I study Application Programming Interfaces (APIs) and related tech and develop content [eBooks, blogs, whitepapers, graphic design] paired with high-impact publishing strategies. I live and work in Seattle, and spend most of my time as Editor in Chief for Nordic APIs, a blog and knowledge center for API providers. For a time I was a Directory Manager & Associate Editor at ProgrammableWeb, and still add new APIs to the directory every now and then. Let's connect on Twitter at @DoerrfeldBill, or follow me on LinkedIn.