wang_quan_li的专栏

作者： 阮一峰 OAuth是一个关于授权（authorization）的开放网络标准，在全世界得到广泛应用，目前的版本是2.0版。 本文对OAuth 2.0的设计思路和运行流程，做一个简明通俗的解释，主要参考材料为RFC 6749。 一、应用场景 为了理解OAuth的适用场合，让我举一个假设的例子。 有一个"云冲印"的网站，可以将用户储存在Google的照片，冲印出来。用户为

最近自己需要做Web API 服务，看了下这份文档，结合自己理解简单做了下总结，供参考： 英文原文下载：api-design-ebook-2012-03.pdf 目标要明确。 用Web API我们是要达到一个什么目的？API的主要职责在于为开发者提供服务，提高开发效率，设计过程中始终应该思考如何能为开发者带来更多益处。因此，在设计API时应多以开发者的视角来思考问题。这个基本

有人言，好的API设计是编程工作中最难的事情。甚至有人认为至少要有10年的工作经验才能接触它。其实通过好的培训或导师学习这个进度可以缩短很多，也有这样或那样的时候，一些没有经验的程序员却设计出好的API。不过这里引发出一个问题：“究竟是构建什么样的库需要花费10年的学习时间？”    那么到底怎么才能设计出好的API？    在走出校门后，我很幸运地加入到Atalasoft公司，这是一家生

作者： 阮一峰 网络应用程序，分为前端和后端两个部分。当前的发展趋势，就是前端设备层出不穷（手机、平板、桌面电脑、其他专用设备......）。 因此，必须有一种统一的机制，方便不同的前端设备与后端进行通信。这导致API构架的流行，甚至出现"API First"的设计思想。RESTful API是目前比较成熟的一套互联网应用程序的API设计理论。我以前写过一篇《理解RESTful架构

作者： 阮一峰 越来越多的人开始意识到，网站即软件，而且是一种新型的软件。 这种"互联网软件"采用客户端/服务器模式，建立在分布式体系上，通过互联网通信，具有高延时（high latency）、高并发等特点。 网站开发，完全可以采用软件开发的模式。但是传统上，软件和网络是两个不同的领域，很少有交集；软件开发主要针对单机环境，网络则主要研究系统之间的通信。互联网的兴起，使得这两个领域开

有几篇不错的文章收藏一下： PHP REST Example Getting started with the Research Advanced GetPriceResearch API How To: Making a PHP REST client to call REST resources Create a REST API with PHP REST 风格的应用程序实现

Prologue 在写API的过程中有这样三种产物 文档 几乎没人爱写文档，写了也懒得维护。可是同时API的文档对于其他程序员来说又是赖以生存的必需品。因此大家对文档都是爱恨交加，恨自己要维护文档，爱别人写好的漂亮文档；恨别人的烂文档错文档，爱自己随便乱写乃至不写文档。 操场 比文档更高一个层次的奢侈品，不用写代码简单点点或者repl形式马上就能探索接口的行为。不像仅对别