REST

  SOAP Web API采用RPC风格，它采用面向功能的架构，所以我们在设计SOAP Web API的时候首相考虑的是应高提供怎样的功能（或者操作）。RESTful Web API采用面向资源的架构，所以在设计之初首先需要考虑的是有哪些资源可供操作。 http://www.cnblogs.com/artech/p/3506553.html 

 RESTFUL设计涉及的细节：URI的命名规范（最好加上版本号；用名词不要用动词；），API返回时的注意事项（如果记录数量很多，服务器不可能都将它们返回给用户，API应该提供参数，过滤返回结果；出错的话，返回出错信息；RESTful API最好做到Hypermedia，即返回结果中提供链接，连向其他API方法，使得用户不查文档，也知道下一步应该做什么。）具体可参考 http://www.ruanyifeng.com/blog/2014/05/restful_api.html