RESTful 介绍及设计思路
- Principles of good RESTful API Design(译:好 RESTful API 的设计原则 )简单易懂,条理清晰,推荐
- Best Practices for Designing a Pragmatic RESTful API(译:RESTful 最佳实践 、译文2)有实际的案例 Enchant
* HTTP API Design Guide(译:HTTP API 设计指南) - Some REST best practices
- 理解 RESTful 架构 - 阮一峰 简单了解什么是 RESTFul
- RESTful API 设计指南 - 阮一峰
* Restful API 的设计规范 实战经验的总结,具有较强的启发意义 - 撰写安全合格的REST API 利用好 HTTP 协议所具备的特征
- Web 服务编程,REST 与 SOAP REST与传统的面向服务的接口设计的区别,启发性强
- 最佳实践:更好的设计你的 REST API 了解 REST 实现缓存的过程
- Thoughts on RESTful API Design
- REST API Tutorial 全方位介绍 REST
- HTTP 接口设计指北
- Web API Design 接口就是开发人员提供的“界面”,用户体验在接口设计上同样重要,在线查看 2012 版、2013 版
知识碎片
- 理解 HTTP 幂等性 讲得很清楚,推荐
- 浅析远程过程调用 RPC 告诉你什么是 RPC
- httpstatuses 一眼看完所有常用的 HTTP 状态码,还可以看详细含义
- json-api 对 API 应该如何利用好 JSON 的一些建议
- 介绍 JSON 无论如何都应该读一遍
- decision-graph.svg 一张大图展示整个 REST API 的验证过程,及各种状态码出现的时机
书籍
- [RESTful Web APIs](http://www.amazon.cn/RESTful-Web-APIs中文版-伦��* %B3%E5%BE%B7%C2%B7%E7%90%86%E6%9F%A5%E5%BE%B7%E6%A3%AE/dp/B00KWGEI64/) 较新的一本书,对 REST 做了很多系统性的总结,尤其对“超媒体”作了详细的介绍
- Jersey-2.x-User-Guide(译:Jersey 2.x 用户指南)译者也提供了入门简易教程 REST 实战以及综合实例 RestDemo(注:读者需要 Java 基础)
- REST CookBook 基础介绍构建 RESTful API
例子
- Github API v3 被很多人参考和引用,比如对分页的处理方法、接口版本的设计等等
- Mailgun Documentation 邮件服务 REST API
- Enchant REST API
- Coinbase API 设计的挺好的,包括官网提供的接口客户端,都是具有参考意义的
- OpenNMS Wiki ReST API