2000年初，DouglasCrockford宣称JavaScript是世界上被误解得最深的一门编程语言。造成误解的主要原因是糟糕的命名方式、设计上的错误和不严格的标准，等等。所以说，导致这种误解是很自然的。

 

　　去年，我在推特上发了一条有关REST架构范式的推文。

　　大多数人认为基于URL和HTTP动词设计的API就是RESTAPI，但这样的想法实际上错得离谱。

 

　　这个误解存在了很长一段时间。与JavaScript不一样的是，REST指南已经说得很清楚了，REST这个名词强调了状态转换（StateTransfer），但大多数所谓的RESTAPI设计者却忽略了这一点。

 

　　如果你问一下身边的程序员他们设计的API是否支持HATEOAS，他们十有八九会瞪大了眼睛看着你，然后说：你到底在说什么？

 

　　然而，REST的名字本身就说明了一切。它并没有说要使用哪一种协议，也没有说使用哪一种方式来标识资源，它只说到表示性状态转移（REpresentationalStateTransfer）。RoyFielding博士说，状态转移管理是RESTAPI的一个必要条件。

 

　　真正的RESTAPI应该为客户端提供状态以及在状态之间进行切换的方式。它提供了资源的表示（不一定是JSON格式）和指向相关资源的链接（超链接），这些链接可以让应用程序从一个状态切换到另一个状态。如下例所示：

 

　　{"id":463219,"firstName":"John","lastName":"Smith","company":"AcmeInc.","salary":72500,"links":[{"href":"https://api.myapp.com/employees/employee/463219","rel":"self"},{"href":"https://api.myapp.com/companies/company/375","rel":"company"},{"href":"https://api.myapp.com/payments/employee/463219","rel":"payments"}]}

 

　　这个例子提供了资源的描述和其他相关资源的信息。

 

　　需要特别提到的是，是否使用HTTP协议并不重要。REST的关键之处在于让服务器端来负责客户端的状态转移。客户端的状态几乎是由服务器端来驱动的，所以，讨论API版本管理并没有多大意义。客户端只要知道RESTAPI的入口点就可以了，剩下的根据服务器端的响应来做决定，但这一点却被大多数人忽略了。

 

　　只是简单地将CRUD操作映射到HTTP动词的API与应用程序状态转移丝毫扯不上关系，你可以把它们叫作WebAPI或HTTPAPI，但请不要把它们叫作RESTAPI。

 

　　点个在看少个bug