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