人工智能服务 REST API 响应的 JSON 格式
什么是 REST API?
REST API 也称为 RESTful API,是遵循 REST 架构规范的应用编程接口(API 或 Web API),支持与 RESTful Web 服务进行交互。REST 是表述性状态传递的英文缩写,由计算机科学家 Roy Fielding 创建。
如何实现 RESTful API?
API 要被视为 RESTful API,必须遵循以下标准:
- 客户端-服务器架构由客户端、服务器和资源组成,并且通过 HTTP 管理请求。
- 无状态客户端-服务器通信,即 get 请求间隔期间,不会存储任何客户端信息,并且每个请求都是独立的,互不关联。
- 可缓存性数据:可简化客户端-服务器交互。
- 组件间的统一接口:使信息以标准形式传输。这要求:
- 所请求的资源可识别并与发送给客户端的表述分离开。
- 客户端可通过接收的表述操作资源,因为表述包含操作所需的充足信息。
- 返回给客户端的自描述消息包含充足的信息,能够指明客户端应该如何处理所收到的信息。
- 超文本/超媒体可用,是指在访问资源后,客户端应能够使用超链接查找其当前可采取的所有其他操作。
- 组织各种类型服务器(负责安全性、负载平衡等的服务器)的分层系统会参与将请求的信息检索到对客户端不可见的层次结构中。
- 按需编码(可选):能够根据请求将可执行代码从服务器发送到客户端,从而扩展客户端功能。
虽然 REST API 需要遵循这些标准,但是