当前位置: 首页 > 软件库 > Web应用开发 > >

restful-api-design-references

RESTful API 设计参考文献
授权协议 MIT
开发语言 Java
所属分类 Web应用开发
软件类型 开源软件
地区 国产
投 递 者 燕智
操作系统 跨平台
开源组织
适用人群 未知
 软件概览

restful-api-design-references是RESTful API 设计参考文献列表,可帮助你更加彻底的了解REST风格的接口设计。

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. 架构风格与基于网络应用软件的架构设计 原汁原味的博士论文,由李锟翻译,有经验的同学可以挑战一下

知识碎片

  1. 理解 HTTP 幂等性 讲得很清楚,推荐

  2. 浅析远程过程调用 RPC 告诉你什么是 RPC

  3. httpstatuses 一眼看完所有常用的 HTTP 状态码,还可以看详细含义

  4. json-api 对 API 应该如何利用好 JSON 的一些建议

  5. 介绍 JSON 无论如何都应该读一遍

  6. decision-graph.svg 一张大图展示整个 REST 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 高亮效果挺好看的

  • 之所以创建这个 repository,是因为我希望收集一些比较好的有关于 RESTful API 设计的参考文献。偶尔回顾,偶尔改进,大家一起来吧~ 如果你有更好的私藏文章,不凡分享出来,独乐乐不如众乐乐,(⊙o⊙) RESTful 介绍及设计思路 Principles of good RESTful API Design(译:好 RESTful API 的设计原则 )简单易懂,条理清晰,推荐 B

  • 作者:suhua su 链接:http://www.zhihu.com/question/28557115/answer/47846156 来源:知乎 著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。 1、REST 是面向资源的,这个概念非常重要,而资源是通过 URI 进行暴露。 URI 的设计只要负责把资源通过合理方式暴露出来就可以了。对资源的操作与它无关,操作是通过 HTT

  • https://github.com/aisuhua/restful-api-design-references 之所以创建这个 repository,是因为我希望收集一些比较好的有关于 RESTful API 设计的参考文献。偶尔回顾,偶尔改进,大家一起来吧~ 如果你有更好的私藏文章,不凡分享出来,独乐乐不如众乐乐,(⊙o⊙) RESTful 介绍及设计思路 Principles of good

  • RESTful API 设计规范 Table of Contents RESTful API 设计规范 关于「能愿动词」的使用 Protocol API Root URL Versioning 在 URL 中嵌入版本编号 通过媒体类型来指定版本信息 Endpoints HTTP 动词 Filtering Authentication Response 200 ok 201 Created 202

  • 1. URI URI 表示资源,资源一般对应服务器端领域模型中的实体类。 URI规范 不用大写; 用中杠-不用下杠_; 参数列表要encode; URI中的名词表示资源集合,使用复数形式。 资源集合 vs 单个资源 URI表示资源的两种方式:资源集合、单个资源。 资源集合: /zoos //所有动物园 /zoos/1/animals //id为1的动物园中的所有动物 单个资源: /zoos/1 /

  • 天蓬老师2017-04-10 15:39:512楼 因为 RESTful API 都是基于HTTP的,也就是说,只要你有一个HTTP客户端(比如浏览器,用PHP的curl库模拟等等)就可以与API通信了。 你上面看到的都是客户端与API在基于HTTP协议进行通信时的一些HTTP头信息与数据,比如你打开谷歌浏览器的开发者工具,然后选择网络(Network)就可以看到本次通讯的所有HTTP相关信息了。

  • Spring Boot and RESTful API(9)Email Sending Add FreeMarker Plugin in Eclipse http://tools.jboss.org/downloads/devstudio/oxygen/11.0.0.GA.html#marketplace There are several html email templates https:/

  • 作者:suhua su 链接:https://www.zhihu.com/question/28557115/answer/47846156 来源:知乎 首先要明确一点:REST 实际上只是一种设计风格,它并不是标准。(所以你可以看到网上一大堆的各种最佳实践,设计指南,但是没有人说设计标准)。aisuhua/restful-api-design-references · GitHub说说几个重要的

  • https://github.com/akon-git/restful-api-design-references http://www.pythondoc.com/flask-restful/first.html https://www.jianshu.com/p/81cd461c7e8f http://www.pythondoc.com/Flask-RESTful/ https://www.j

 相关资料
  • 我正在为RESTful API寻找URI设计方面的一些方向。我将有几个嵌套的链接资源,并且目前已经设计了与本文类似的URI:分层RESTful URL设计 我的问题是: 第二个示例是有效的REST设计吗? 是否应考虑实现这两种路径?

  • REST从资源的角度来观察整个网络,分布在各处的资源由URI确定,而客户端的应用通过URI来获取资源的表征。获得这些表征致使这些应用程序转变了其状态。随着不断获取资源的表征,客户端应用不断地在转变着其状态,所谓表征状态转移。 因为我们需要的是一个Machine到Machine沟通的平台,需要设计一个API。而设计一个API来说,RESTful是很不错的一种选择,也是主流的选择。而设计一个RESTf

  • 注:内容来自官方 Reference Overview 这个章节包含在C++, Java, Python, Go, C#, 和 Objective C中使用protocol buffer类的参考文档,还有一些protocol buffer自身的参考文档。每个语言的文档包含: 从.proto文件用protocol buffer编译器生成的代码的参考指南 为提供的源代码而生成的API文档 注意还有更多

  • 这是一份网络API的通用设计指南。Google 内部从2014年开始使用它,我们在设计 Cloud AP I和 Google API 时也遵从了这份指南。我们把它分享给 Google 以外的开发人员,这也会让我们的合作变得更顺利。

  • 这份文档提供Django 认证系统组件的API 参考资料。对于这些组件的用法以及如何自定义认证和授权请参照认证主题的相关指南。 字段 class models.``User User 对象具有如下字段: username 必选。少于等于30个字符。 用户名可以包含字母、数字、_、@、+、.和- 字符。 first_name 可选。 少于等于30个字符。 last_name 可选。少于30个字符。

  • 基于类的视图的API 参考。另请参见基于类的视图 的简介。 基础视图 View TemplateView RedirectView 通用的显示视图 DetailView ListView 通用的编辑视图 FormView CreateView UpdateView DeleteView 通用的日期视图 ArchiveIndexView YearArchiveView MonthArchiveVie