幾個 json api 設計的參考資料

RESTful API 设计指南
http://www.ruanyifeng.com/blog/2014/05/restful_api.html

A standard for building APIs in JSON.
http://jsonapi.org/

REST Assured - Hypermedia APIs with Spring MVC
http://java.dzone.com/articles/rest-assured-hypermedia-apis

REST+JSON API Design - Best Practices for Developers
http://www.youtube.com/watch?v=hdSrT4yjS1g

HATEOAS
http://en.wikipedia.org/wiki/HATEOAS

DR. Roy T. Fielding - Representational State Transfer (REST)
http://www.ics.uci.edu/~fielding/pubs/dissertation/rest_arch_style.htm

範例 - How to GET a Cup of Coffee
http://www.infoq.com/articles/webber-rest-workflow



因為要定義api規格，找到許多文章提到 hypermedia api，
研究了半天，原來 hypermedia api 不是指規格，是指一種概念。

簡單的說，Hypermedia API 是其中一種 RESTful API。
Hypermedia API = HTTP + JSON + HATEOAS 。
HATEOS= Hypermedia as the Engine of Application State。

主要目的，是為了降低 client-server 的 耦合度，
把server提供的資料來源，相關資料，資料狀態，工作流程等，都定義在API裡頭。