3 Star 6 Fork 0

Gitee 极速下载 / restful-api-design-references

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
此仓库是为了提升国内下载速度的镜像仓库,每日同步一次。 原始仓库: https://github.com/aisuhua/restful-api-design-references
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README
MIT

之所以创建这个 repository,是因为我希望收集一些比较好的有关于 RESTful API 设计的参考文献。偶尔回顾,偶尔改进,大家一起来吧~

如果你有更好的私藏文章,不凡分享出来,独乐乐不如众乐乐,(⊙o⊙)

RESTful 介绍及设计思路

  1. Principles of good RESTful API Design(译:好 RESTful API 的设计原则 )简单易懂,条理清晰,推荐
  2. Best Practices for Designing a Pragmatic RESTful API(译:RESTful 最佳实践 译文2)有实际的案例 Enchant
  3. HTTP API Design Guide(译:HTTP API 设计指南
  4. Some REST best practices
  5. 理解 RESTful 架构 - 阮一峰 简单了解什么是 RESTFul
  6. RESTful API 设计指南 - 阮一峰
  7. Restful API 的设计规范 实战经验的总结,具有较强的启发意义
  8. 撰写安全合格的REST API 利用好 HTTP 协议所具备的特征
  9. Web 服务编程,REST 与 SOAP REST 与传统的面向服务的接口设计的区别,启发性强
  10. 最佳实践:更好的设计你的 REST API 了解 REST 实现缓存的过程
  11. Thoughts on RESTful API Design
  12. REST API Tutorial 全方位介绍 REST
  13. HTTP 接口设计指北
  14. Web API Design 接口就是开发人员提供的“界面”,用户体验在接口设计上同样重要,在线查看 2012 版2013 版
  15. 架构风格与基于网络应用软件的架构设计 原汁原味的博士论文,由李锟翻译,有经验的同学可以挑战一下
  16. Microsoft REST API Guidelines 微软官方的 REST API 设计指南,值得参考

知识碎片

  1. 理解 HTTP 幂等性 讲得很清楚,推荐
  2. 浅析远程过程调用 RPC 告诉你什么是 RPC
  3. httpstatuses 一眼看完所有常用的 HTTP 状态码,还可以看详细含义
  4. List of HTTP status codes From Wikipedia
  5. HTTP Status Codes From MSDN Microsoft
  6. List of HTTP header fields
  7. json-api 对 API 应该如何利用好 JSON 的一些建议
  8. 介绍 JSON 无论如何都应该读一遍
  9. decision-graph.svg 一张大图展示整个 REST API 的验证过程,及各种状态码出现的时机

书籍

  1. RESTful Web APIs 较新的一本书,对 REST 做了很多系统性的总结,尤其对“超媒体”作了详细的介绍
  2. Jersey-2.x-User-Guide(译:Jersey 2.x 用户指南)译者也提供了入门简易教程 REST 实战以及综合实例 RestDemo(注:读者需要 Java 基础)
  3. REST CookBook 基础介绍构建 RESTful API

例子

  1. Github API v3 被很多人参考和引用,比如对分页的处理方法、接口版本的设计等等
  2. Mailgun Documentation 邮件服务 REST API
  3. Enchant REST API
  4. Coinbase API 设计的挺好的,包括官网提供的接口客户端,都是具有参考意义的
  5. OpenNMS Wiki ReST API
  6. REST API 使用详解 Lean Cloud 中讲解 REST API 的使用,还集成 Swagger UI 在线调试工具,点击查看

关于例子,实在是太多了,在有时间的时候,多观察别人的设计,有利于写出好的 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 高亮效果挺好看的

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

社区

  1. API Craft Google Group 有梯子才行
  2. RESTful - 知乎 我也有作答~~

其他

  1. MarkdownPad2 Windows 下使用 Markdown 语法编写文档。等习惯了它的语法,可以直接使用任何一款文本编辑器直接写了
  2. HTTP API Development Tools This is a collection of useful resources for building RESTful HTTP+JSON APIs.
The MIT License (MIT) Copyright (c) 2015 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

简介

暂无描述 展开 收起
Java
MIT
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
Java
1
https://gitee.com/mirrors/restful-api-design-references.git
git@gitee.com:mirrors/restful-api-design-references.git
mirrors
restful-api-design-references
restful-api-design-references
master

搜索帮助