12 设计RESTful API

设计RESTful API是一个有意思的话题。下面是一些常用的RESTful设计原则:

12.1　REST关键目标

• 组件间交互的可伸缩性
• 接口的通用性
• 组件的独立部署
• 通过中间组件来减少延迟、实施安全策略和封装已有系统

12.2　判断是否是 RESTful的约束条件

• 客户端-服务器分离
• 无状态
• 可缓存
• 多层系统
• 统一接口
• 随需代码（可选）

12.3　设计RESTful资源

12.4　设计RESTful URI

12.5　JSON

12.6　REST

REST从资源的角度来观察整个网络，分布在各处的资源由URI确定，而客户端的应用通过URI来获取资源的表征。获得这些表征致使这些应用程序转变了其状态。随着不断获取资源的表征，客户端应用不断地在转变着其状态，所谓表征状态转移。

因为我们需要的是一个Machine到Machine沟通的平台，需要设计一个API。而设计一个API来说，RESTful是很不错的一种选择，也是主流的选择。而设计一个RESTful服务，的首要步骤便是设计资源模型。

12.6.1　资源

互联网上的一切信息都可以看作是一种资源。

|

HTTP Method

|

Operation Performed

GET

|

Get a resource (Read a resource)

POST

|

Create a resource

PUT

|

Update a resource

DELETE

|

Delete Resource

|