3、REST API 开发：原理、对比与设计最佳实践

REST API 开发：原理、对比与设计最佳实践

1. REST 相关基础概念

1.1 作者列表与资源表示

在某些 API 端点中，完整的作者列表可能无法获取。这是因为在特定用例中不需要该列表，所以 API 不会返回它。不过，在根端点中可能存在该列表，若客户端在向最终用户展示信息时需要，仍可获取。

每个链接都包含一个属性，用于指定该资源表示的内容类型。若资源有多种可能的表示形式，可在每个资源的元数据元素中添加不同的链接，让客户端根据当前用例选择最合适的格式，或者根据客户端的偏好改变类型（内容协商）。

1.2 HAL 标准

为了避免因缺乏标准结构而影响开发者与系统交互的体验，采用 Hypertext Application Language（HAL）是个不错的选择。HAL 尝试为 XML 和 JSON 表示资源创建标准，它定义的表示包含两个主要元素：资源和链接。

资源具有链接、嵌入式资源（与父资源关联的其他资源）和状态（描述资源的实际属性）。链接则有目标（URI）、关系以及一些处理弃用、内容协商等的可选属性。

以下是一个遵循 HAL 标准的 JSON 响应示例：

{
  "_embedded": [
    {
      "title": "Harry Potter and the Half Blood prince",
      "description": "......",
      "copies": 10,
      "_embedded": {
        "author": {