为多对多关系构建RESTful API

Question

我目前正在为具有三种类型的数据的应用程序创建一个API; Files，Tags和Persons。这些都是常规联系的;一个File有许多Tags和Persons连接到它。

问题是，我不知道如何使用RESTful API实际连接它们。 Persons和Tags对于File是必不可少的，所以它们会自动返回，而不需要任何进一步的请求。

下面是我在看现在的Files结构的一个例子：

GET /tags 
GET /tags/:id 
POST /tags 
PUT /tags/:id 
PATCH /tags/:id 

而对于Persons：

GET /files 
GET /files/:id 
POST /files 
PUT /files/:id 
PATCH /files/:id 

而对于Tags

GET /persons 
GET /persons/:id 
POST /persons 
PUT /persons/:id 
PATCH /persons/:id 

由于你可以看到，它们与intentio完全一样使我的API易于记录。但问题在于，对于多对多的关系，我不知道如何将给定的Tag或Person链接到File。

我正在考虑这个：

POST /files/:id/tags 
DELETE /files/:id/tags/:id 

但似乎有点笨重。

什么是我的情况的理想结构？

Answer 1

这些都是常规链接;一个文件有许多标签和人员附加到它。

然后PATCH /files/:id终点似乎是一个好地方：

PATCH /files/:id 
{ 
    "PersonIds": [ 1, 2, 3 ], 
    "TagIds": [ 4, 5 ] 
} 

这将Persons和Tags更新File协会和保持文件不变的其他属性（这是PATCH点动词 - 部分更新）。