网络应用程序，分为前端和后端两个部分。当前的发展趋势，就是前端设备层出不穷（手机、平板、桌面电脑、其他专用设备......）。 因此，必须有一种统一的机制，方便不同的前端设备与后端进行通信。这导致API构架的流行，甚至出现"API First"的设计思想。RESTful API是目前比较成熟的一套互 ...
原文：http://www.ruanyifeng.com/blog/2018/10/restful-api-best-practices.html 阮一峰老师的文章，他的文章把难懂的东西讲的易懂 RESTful 是目前最流行的 API 设计规范，用于 Web 数据接口的设计。 它的大原则容易把握，但 ...
put 没改的字段（属性）也提交 PATCH 只提交改的字段（属性） 状态码：分析和调试 API身份认证 使用OAUth.2.0框架 服务器返回的数据格式，应该尽量使用JSON，避免使用XML SDK：示例代码（范例），使用指南 ...
我在API设计中收到的最常见问题之一就是如何对API进行版本控制。虽然并非所有API都完全相同，但我发现在API版本控制方面，某些模式和实践适用于大多数团队。我已经将这些内容收集起来，下面将提供一些关于版本控制策略的建议，该策略将帮助大多数API提供商，无论他们是向内部署API，还是对外的API。 ...
阅读目录 一、创建资源使用PUT还是POST 二、异常处理的HTTP响应状态码 三、返回数据是否需要包装 四、URI的设计层级是否超过两层 五、参考资料 阅读目录 一、创建资源使用PUT还是POST 二、异常处理的HTTP响应状态码 三、返回数据是否需要包装 四、URI的设计层级是否超过两层 五、参 ...
1.RESTful 1.1 定义 REST(Representational State Transfer)与技术无关，代表一种软件架构风格，中文为表征状态转移。 1.2 RESTful API设计 API与用户的通信协议，总是使用HTTPS协议 域名 https://api.example.com ...
分类：
其他好文 时间：
2019-07-25 23:11:34
阅读次数：
137
什么是restful Restful api设计 什么是restful 1、Rest与技术无关，代表的是一种软件架构风格，中文成为"表征状态转移" 2、Rest从资源的角度审视整个网络，它将分布在网络中某个节点的资源通过url进行表示，客户端应用通过url来获取资源的表征，获得这些表征致使这些应用转... ...
分类：
其他好文 时间：
2019-07-02 00:11:36
阅读次数：
105
this和对象原型 第一章 关于this 1.1 为什么要用this this 提供了一种更优雅的方式来隐式“传递”一个对象引用，因此可以将 API 设计 得更加简洁并且易于复用。显式传递上下文对象会让代码变得越来越混乱，使用 this 则不会这样。 1.2 误解 1.2.1 指向自身 除了函数对象 ...
分类：
其他好文 时间：
2019-06-27 16:26:08
阅读次数：
90
网络应用程序，分为前端和后端两个部分。当前的发展趋势，就是前端设备层出不穷（手机、平板、桌面电脑、其他专用设备......）。 因此，必须有一种统一的机制，方便不同的前端设备与后端进行通信。这导致API构架的流行，甚至出现"API First"的设计思想。RESTful API是目前比较成熟的一套互 ...
创建一些工具 创建工具是帮助他人的一种很好的方式，而且不用考虑太多复杂的问题或 API 设计。你可以开发一个你最喜欢的框架或平台的模板。你可以将到的知识和工具集中到一个项目中进行很好的诠释，并做好随时更新和发布新特性的准备 1.使用成熟稳定的开源项目 现在技术日新月异，可能隔几天就会出来一个新的开源 ...
分类：
其他好文 时间：
2019-06-19 18:43:12
阅读次数：
89
