Rest API 是否可以在资源中返回单个用户数据？

Question

举例来说，假设我有一个 API 来处理将书籍的详细信息传递回移动应用程序。用户可以浏览书籍列表，并将书籍添加到他们的愿望 list 中。

我的问题是，在退回一本书或一本书集时，在每个图书资源中包含特定于用户的信息是否是一种好习惯？我的意思是，对于每本书，是否可以包含一个字段来表示该书是否在用户的愿望 list 中，或者该列表是否会单独返回并由移动应用程序执行此检查。

移动应用程序开发人员更愿意调用/books 并收到类似这样的响应；

{
  "books": [
    {
      "id":1,
      "name": "How to be good at everything",
      "price": 3.99,
      "in_wish_list": true
    },
    {
      "id":2,
      "name": "How to be good at nothing",
      "price": 6.50,
      "in_wish_list": false
    }
    ]
}

我认为我更愿意将这些数据拆分到多个端点；

/用户/29/愿望 list

{
  "wishlist": [1,7,9,34,28]
}

/图书

{
  "books": [
    {
      "id":1,
      "name": "How to be good at everything",
      "price": 3.99
    },
    {
      "id":2,
      "name": "How to be good at nothing",
      "price": 6.50
    }
    ]
}

这样，移动应用程序负责确定一本书是否在用户的愿望 list 中。

我可以看到将用户数据嵌入到图书资源中的好处，但感觉不对。

我想知道其他人如何管理这种情况？

Answer 1

现在这一切都取决于谁将使用您的 API，以及如何使用。如果需要显示用户的愿望 list 书籍，则必须有一个单独的端点。当然，移动客户端开发人员更喜欢一个大调用而不是几个较小的调用，但您也可以妥协并拥有一个单独的用户愿望 list 端点(同样，如果有用例场景)，并为每本书返回一个 bool 值 - 这样，对您的 API 的调用次数甚至可能会减少。