RESTful API 设计参考文献列表
来自: http://segmentfault.com/a/1190000004353103
之所以创建这个 repository,是因为我希望收集一些比较好的有关于 RESTful API 设计的参考文献。偶尔回顾,偶尔改进,大家一起来吧~
如果你有更好的私藏文章,不凡分享出来,独乐乐不如众乐乐,(⊙o⊙)
RESETful 介绍及设计思路
-
Principles of good RESTful API Design(译:好 RESTful API 的设计原则 )简单易懂,条理清晰,推荐
-
Best Practices for Designing a Pragmatic RESTful API(译:RESTful 最佳实践 译文2)有实际的案例 Enchant
-
理解 RESTful 架构 - 阮一峰 简单了解什么是 RESTFul
-
RESTful API 设计指南 - 阮一峰
-
Restful API 的设计规范 实战经验的总结,具有较强的启发意义
-
撰写安全合格的REST API 利用好 HTTP 协议所具备的特征
-
Web 服务编程,REST 与 SOAP REST 与传统的面向服务的接口设计的区别,启发性强
-
最佳实践:更好的设计你的 REST API 了解 REST 实现缓存的过程
-
REST API Tutorial 全方位介绍 REST
知识碎片
-
理解 HTTP 幂等性 讲得很清楚,推荐
-
浅析远程过程调用 RPC 告诉你什么是 PRC
-
httpstatuses 一眼看完所有常用的 HTTP 状态码,还可以看详细含义
-
json-api 对 API 应该如何利用好 JSON 的一些建议
-
介绍 JSON 无论如何都应该读一遍
-
decision-graph.svg 一张大图展示整个 REST API 的验证过程,及各种状态码出现的时机
书籍
-
RESTful Web APIs 较新的一本书,对 REST 做了很多系统性的总结,尤其对“超媒体”作了详细的介绍
-
REST 实战 基于 Jersey 构建 RESTful 服务,有实际的案例 RestDemo(我注:读者需要懂一些 Java )
-
Jersey 2.x 用户指南 该书是 Java REST 的规范实现之一 Jersey 用户手册,中文翻译(我注:读者需要懂一些 Java )
例子
-
Github API v3 被很多人参考和引用,比如对分页的处理方法、接口版本的设计等等
-
Mailgun Documentation 邮件服务 REST API
-
Coinbase API 设计的挺好的,包括官网提供的接口客户端,都是具有参考意义的
关于例子,实在是太多了,在有时间的时候,多观察别人的设计,有利于写出好的 API。
调试工具
-
DHC (aka Dev HTTP Client) Chrome 插件,简单易用,可分类管理,界面友好。也很多人推荐 Postman
-
Fiddler2 抓包,捕捉每一次 REST 请求和响应的详细内容
文档制作
-
slate 创建的 API 文档很好看,也很实用,三列式,目录、调用说明和代码示例同屏滚动显示。
-
i5ting_ztree_toc API 把 Markdown 文档生成简单的 HTML API
代码高亮
-
highlight.js 无需指定代码是什么语言,直接按 TAB 键搞掂,它会自动检测高亮
-
PrismJS 高亮效果挺好看的
这方面的工具很多,可以自己在网上找找,找一款适合自己的就可以,毕竟只是工具,能达到目的就好。
社区
-
API Craft Google Group 有梯子才行
-
RESTful - 知乎 我也有作答~~
其他
-
MarkdownPad2 Window 下使用 Markdown 语法编写文档。等习惯了它的语法,可以直接使用任何一款文本编辑器直接写了