json-api - JSONAPI - 链接资源中的自身和相关资源之间的区别

Question

为什么是self and related下面的 JSONAPI 资源中的引用不同吗？他们不是指向同一个资源吗？转到 /articles/1/relationships/tags 和 /articles/1/tags 有什么区别？

{
  "links": {
    "self": "/articles/1/relationships/tags",
    "related": "/articles/1/tags"
  },
  "data": [
    { "type": "tags", "id": "2" },
    { "type": "tags", "id": "3" }
  ]
}

Answer 1

您可以在这里阅读:https://github.com/json-api/json-api/issues/508 。

基本上，/articles/1/relationships/tags 响应将是表示 articles 和 tags 之间关系的对象。响应可能是这样的(您在问题中输入的内容):

{
  "links": {
    "self": "/articles/1/relationships/tags",
    "related": "/articles/1/tags"
  },
  "data": [
    { "type": "tags", "id": "2" },
    { "type": "tags", "id": "3" }
  ]
}

此响应仅提供操作关系所需的数据(在主数据属性中 - 数据)，而不提供与关系相关的资源。话虽这么说，如果您想创建新关系，添加新标签，您将调用/articles/1/relationships/tags(基本上更新关系)到文章，读取哪些标签属于文章(您只需要身份即可在服务器上搜索它们)或删除文章标签。

另一方面，调用 /articles/1/tags 将以标签作为主要数据及其拥有的所有其他属性进行响应(articles、关系、链接和其他顶级属性，例如包含、强调文本、>链接和/或jsonapi)。