API Resources for Software Development

REST provides significant advantages over RPC-based architectures.  When it comes to designing REST APIs, one can probably divide the work into these areas:

1. Identifying resources or things that you want to perform operations on.
2. Modeling these objects /resources - what fields and attributes are present.
   
3. Documentation format - RAML , swagger or others
4. Hypermedia format - json collection, HAL, Siren, JSONAPI or others

Resources

• API Evangelist - he has been doing research the longest on the topic of APIs and his work iOS highly respected http://apievangelist.com/
• RESTful Web APIs - great book to have as a reference http://shop.oreilly.com/product/mobile/0636920028468.do
• APIstrat - great conference on APIs, all of their presentations are available online http://apistrategyconference.com/
• Blog entry on platforms as a culture - https://plus.google.com/+RipRowan/posts/eVeouesvaVX

Credits

• José Cedeño at Oregon State University for providing the above.