RESTful Web 服务就是基于 REST 架构的 Web 服务,在 REST 架构中一切都是资源。RESTful Web 服务是轻量级的,高度可伸缩和可维护的,通常用于给基于 Web 的应用程序创建 APIs。本教程将教会我们 RESTful Web 服务的基础知识,还包含讨论所有 RESTful Web 服务基本组成部分的章节和适当的例子。
本指南描述了一系列 HTTP+JSON API 的设计实践, 来自并展开于 Heroku Platform API 的工作。本指南指导着 Heroku 内部 API 的开发,我们希望也能对 Heroku 以外的 API 设计者有所帮助。
JSON API设计用来最小化请求的数量,以及客户端与服务器间传输的数据量。在高效实现的同时,无需牺牲可读性、灵活性和可发现性。
OAuth 2.0 是目前比较流行的做法,它率先被Google, Yahoo, Microsoft, Facebook等使用。之所以标注为 2.0,是因为最初有一个1.0协议,但这个1.0协议被弄得太复杂,易用性差,所以没有得到普及。2.0是一个新的设计,协议简单清晰,但它并不兼容1.0,可以说与1.0没什么关系。
Google API 使用 OAuth 2.0 协议来进行验证和授权。Google 支持常见的 OAuth 2.0 方案,包括使用 Web 服务器、本地安装的和客户端类型的应用。本指南是 Google Developers 官网 OAuth 2.0 Authorzation 的中文翻译版本。