《WebAPI的设计与开发》读后感
/11/03
《WebAPI的设计与开发》
原名是WebAPI:TheGoodParts,是O’Reilly的图灵程序设计的一本老书,年第一版,年第11次印刷,但还是值得IT人员一看的。作者水野贵明是一个日本人,以美国硅谷著名互联网公司的实际的WebAPI为例,对WebAPI的概念、设计、实施和安全多方面有许多经验总结,具有很强的实际指导意义。O’Reilly的书都比较规范,可以放心的阅读和应用,不像国内的一些书,概念满天飞,说了像没说一样,本地特色很显著。
“
”
一个URL,几个参数,返回一个JSON字符串,似乎WebAPI没有什么了不起的,似乎大家都知道WebAPI是什么,开发和调用起来也很简单。但其实每个公司和个人在制作API的时候在API规范上可能都是五花八门的,可能压根就没有考虑过API的升级和安全。在企业内部简单用用可能问题不大,一旦离开企业内部或大批量使用起来,可能就会不堪重负,丑态百出,形同luo奔。
”
WebAPI的发展也经历了一个过程,硅谷的企业也不例外,他们也是一步一步摸索过来的。还好,现在的WebAPI已经算是老技术了,用的人多了,不约而同的也就有了一定的规范,也总结了一些经验教训。这本算是比较全面的总结了WebAPI的设计经验。
主要章节
具体的内容还得看书,主要章节有:什么是WebAPI,端点是的设计与请求的形式,响应数据的设计,最大限度的利用HTTP协议规范,开发方便更改设计的WebAPI,开发安全的WebAPI。
WebAPI应用模式
列出了几种常见的WebAPI应用模式,即应用场景:在线服务通过API公开,将Widget通过API公开,构建现代的Web应用,开发智能手机应用,开发社交游戏,公司内部系统的集成。
#优美的API#
作者认为API应该公开,才能带来收益。还需要设计“优美的”API。一个优美的WebAPI需要易于使用、便于更改、要具有了良好的健壮性、不怕公之于众。
#端点URI#
短小便于录入,人可以读懂,没有大小写混写,修改要方便,不会暴露服务武器的内部架构,URI的规则要统一。
API其实是给机器使用的,但最好还是让人能够一眼就能看出这个API能够做什么,不要过多的使用会让人摸不着头脑的缩写。
优美的: