RESTful API 设计参考文献列表

书籍

1. RESTful Web APIs 较新的一本书，对 REST 做了很多系统性的总结，尤其对“超媒体”作了详细的介绍

2. REST 实战 基于 Jersey 构建 RESTful 服务，有实际的案例 RestDemo（我注：读者需要懂一些 Java ）

3. Jersey 2.x 用户指南 该书是 Java REST 的规范实现之一 Jersey 用户手册，中文翻译（我注：读者需要懂一些 Java ）

例子

1. Github API v3 被很多人参考和引用，比如对分页的处理方法、接口版本的设计等等

2. Mailgun Documentation 邮件服务 REST API

3. Enchant REST API

4. Coinbase API 设计的挺好的，包括官网提供的接口客户端，都是具有参考意义的

5. OpenNMS Wiki ReST API

关于例子，实在是太多了，在有时间的时候，多观察别人的设计，有利于写出好的 API。

调试工具

1. DHC (aka Dev HTTP Client) Chrome 插件，简单易用，可分类管理，界面友好。也很多人推荐Postman

2. Fiddler2 抓包，捕捉每一次 REST 请求和响应的详细内容

文档制作

1. slate 创建的 API 文档很好看，也很实用，三列式，目录、调用说明和代码示例同屏滚动显示。

2. i5ting_ztree_toc API 把 Markdown 文档生成简单的 HTML API

代码高亮

1. highlight.js 无需指定代码是什么语言，直接按 TAB 键搞掂，它会自动检测高亮

2. PrismJS 高亮效果挺好看的

这方面的工具很多，可以自己在网上找找，找一款适合自己的就可以，毕竟只是工具，能达到目的就好。

• Python 3 入门教程
• 提高代码质量：如何编写函数
• 一周 IT 技术干货
• 浅谈 12306 核心模型设计思路和架构设计
• 大数据职位，数据场技能