JSON API自身与关系URL的相关链接

Question

self链接和JSON API的related链接之间有什么区别？

Answer 1

对于我在响应中实际返回的内容，我很难找到一个简单易懂的答案。

对于JSON API的示例，它们具有以下JSON：

{
  "links": {
    "self": "http://example.com/articles",
    "next": "http://example.com/articles?page[offset]=2",
    "last": "http://example.com/articles?page[offset]=10"
  },
  "data": [{
    "type": "articles",
    "id": "1",
    "attributes": {
      "title": "JSON API paints my bikeshed!"
    },
    "relationships": {
      "author": {
        "links": {
          "self": "http://example.com/articles/1/relationships/author",
          "related": "http://example.com/articles/1/author"
        },
        "data": { "type": "people", "id": "9" }
      },
      "comments": {
        "links": {
          "self": "http://example.com/articles/1/relationships/comments",
          "related": "http://example.com/articles/1/comments"
        },
        "data": [
          { "type": "comments", "id": "5" },
          { "type": "comments", "id": "12" }
        ]
      }
    },
    "links": {
      "self": "http://example.com/articles/1"
    }
  }],
  "included": [{
    "type": "people",
    "id": "9",
    "attributes": {
      "first-name": "Dan",
      "last-name": "Gebhardt",
      "twitter": "dgeb"
    },
    "links": {
      "self": "http://example.com/people/9"
    }
  }, {
    "type": "comments",
    "id": "5",
    "attributes": {
      "body": "First!"
    },
    "relationships": {
      "author": {
        "data": { "type": "people", "id": "2" }
      }
    },
    "links": {
      "self": "http://example.com/comments/5"
    }
  }, {
    "type": "comments",
    "id": "12",
    "attributes": {
      "body": "I like XML better"
    },
    "relationships": {
      "author": {
        "data": { "type": "people", "id": "9" }
      }
    },
    "links": {
      "self": "http://example.com/comments/12"
    }
  }]
}

这行在这里：

"self": "http://example.com/articles/1/relationships/author"

是“关系链接”

这行在这里：

"self": "http://example.com/articles/1/relationships/comments"

也是“关系链接”

是的，我知道这很令人困惑，因为另一个被称为related 。 这些链接的目的是什么？ 目的只是管理关系。 因此，说您执行GET /articles/1/relationships/comments ， 则不返回评论的信息。 您只返回资源类型/ id和其他一些东西的数组，例如元数据和链接。 例：

{ 
  "data": [{
    "type": "comments",
    "id": "13" 
  }, {
    "type": "comments",
    "id": "29" 
  }],
  "links": {
    "self": "http://example.com/articles/1/relationships/comments",
    "next": "http://example.com/articles/1/relationships/comments?page[offset]=2",
    "last": "http://example.com/articles/1/relationships/comments?page[offset]=4"
  },
  "meta": {
    "copyright": "Copyright 2015 Example Corp.",
    "authors": [
      "Zach Aysan"
    ]}
}

为什么这有用？ 因为有时我们只想删除关系，而不是资源（注释，作者）本身。 因此，例如，如果我们执行DELETE /articles/1/relationships/author ，但不会从users表中删除该用户，则只会将该用户删除为author。 要仅删除一些评论，我们执行PATCH /articles/1/relationships/comments ，仅包含我们要保留的评论。 但是请记住，如果后端认为正确的话，可能会删除实际的注释。 （既然没有相关文章的评论有什么好处？）

那其他链接呢？ 为什么是/articles/1/author而不是/people/9 ？ 因为文章的作者可能会在请求和GET /articles/1/author之间更改 ，所以GET /articles/1/author将始终返回当前作者。 这就是为什么我们通常不需要支持PATCH /articles/1/author因为通常更有意义/将更改直接指向资源本身是更安全的。 PATCH /people/9 ，例如，如果有人在“编辑文章”页面上更改其化身。 即使管理员更改了该文章的作者身份， PATCH仍然可以使用正确的资源。

我知道。 这一切都有些乏味，但是一旦理解了所有内容，Ember Data之类的东西就应该齐聚一堂。