REST 和多对多

Question

我的问题基于How to handle many-to-many relationships in a RESTful API?，但想从已接受的答案继续。

假设我们在球员和球队之间有一个多对多的关系（就像上面提到的问题一样）。

据我了解，有几个选项可以使用 REST 资源对此进行建模：

有效负载包含对相关资源的引用

GET /players/john

产量

{
    "name": "John",
    "_links": [
        {
            "rel": "team",
            "href": "/teams/1"
        },
        {
            "rel": "team",
            "href": "/teams/4"
        }
    ]
}

和

GET /teams/1

产量

{
    "name": "Team 1",
    "_links": [
        {
            "rel": "player",
            "href": "/players/john"
        },
        ...
    ]
}

当我只想将一名球员添加到球队时，这会迫使我更新球员资源。此外，当我使用玩家资源将玩家添加到团队时，相应的团队资源会自动更新。根据How to handle many-to-many relationships in a RESTful API?：

您不希望备用 URL /players/5/teams/ 保持缓存状态

在这种情况下，当我更新玩家“John”以从中删除团队“Team 1”时，teams/1 可能会保持缓存！

关系被建模为另一个资源

GET /teams/1

产量

{
    "name": "Team 1",
}

和

GET /players/john

产量

{
    "name": "John",
}

最后，

GET /relationships

产量

    [
    {
        "_links": [
            {
                "rel": "player",
                "href": "/players/john"
            },
            {
                "rel": "team",
                "href": "/teams/1"
            }
        ]
    },

    ...
]

这样，我可以在不影响玩家资源和团队资源的情况下创建和删除关系。但是当我删除/players/john时，匹配关系是否也应该被自动删除？如果是这种情况，则违反了与上述相同的规则。如果不是这种情况，我们需要手动删除这些关系，这是我不想让我的 API 使用者负担的大量工作。

此外，如果我们想要更新某个玩家“John”所在的球队，我们需要删除一些关系并添加其他关系。当其他人正在编辑玩家“John”或团队“Team 1”时，我们会敞开心扉合并冲突（和比赛条件）。

关系的每一方都有自己的关系对象

GET /teams/1/players

产生类似的东西

{
    "_links": [
        {
            "rel": "player",
            "href": "/players/john"
        },
        ...
    ]
}

和

GET /players/john/teams

类似

{
    "_links": [
        {
            "rel": "team",
            "href": "/teams/1"
        },
        ...
    ]
}

但添加或删除一个可能仍会影响位于不同 URL（不共享根元素）的资源

我的问题

我在这两种情况下提到的问题都没有了吗？

这两种方法中哪一种是“首选”或更纯粹的 REST？

我应该对How to handle many-to-many relationships in a RESTful API?中提到的约束有多认真：

您不希望备用 URL /players/5/teams/ 保持缓存状态

提前谢谢你！

Answer 1

你可以有以下

团队

GET /teams/dream

{
    "_links": {
        "self": {
            "href": "/teams/dream"
        }
        "players": {
            "href": "/players?team=dream"
        }
    },
    "name": "Dream"
}

播放器

GET /player/john

{
    "_links": {
        "self": {
            "href": "/player/john"
        },
        "teams": {
            "href": "/teams?player=john"
        },
    },
    "name": "John",
}

约翰的团队

GET /teams?player=john

{
    "_links": {
    },
    "items": [
        {
            "href": "/teams/a-team"
        }
    ],
}

将 john 添加到梦之队，（例如使用 json 补丁）（补丁帖子上的查询字符串...等虽然很少见，但有效）

PATCH /teams?player=john

[{
    "op": "add",
    "path": "/-",
    "value": {
        "href": "/team/dream"
    }
}]

获取约翰的团队

GET /teams?player=john

{
    "_links": {
    },
    "items": [
        {
            "href": "/teams/a-team"
        },
        {
            "href": "/teams/dream"
        }
    ]
}

约翰离开了一个团队：

PATCH /teams?player=john

[{
    "op": "remove",
    "path": "/0"
}]