13 设计 RESTful API

优质
小牛编辑
135浏览
2023-12-01

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

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

13.0.1 资源

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

HTTP MethodOperation Performed
GETGet a resource (Read a resource)
POSTCreate a resource
PUTUpdate a resource
DELETEDelete Resource

13.1 设计RESTful API

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

13.2 REST关键目标

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

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

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

13.4 JSON

xml-vs-json

xml-vs-json