用于链接实体的 REST 端点

Question

我有一个 cars 实体和一个 people 实体，并且有非常匹配的 REST 端点：

curl -i -X POST -H "Content-Type:application/json" http://localhost:8888
     /cars/ -d '{"name":"Fuson","color":"red","foo":"bar"}'

curl -i -X POST -H "Content-Type:application/json" http://localhost:8888
     /people/ -d '{"name":"John","age":"27","foo":"bar"}'

我还有一个多对多people_have_cars entity。

要添加记录，REST 端点应该是什么样的？例如，人和汽车在 URL 中还是在正文中？如果在 URL 中，有什么特别的顺序吗？应该是POST、PUT 还是PATCH？它应该返回什么？

删除多对多记录的同样问题呢？

Answer 1

这取决于关系中哪一方是主人。它看到一个人可以拥有多辆汽车，因此要查看汽车，您应该引入以下端点：

GET /people/{id}/cars/

并为给定的人添加一辆新车：

POST /people/{id}/cars/

curl -i -X POST -H "Content-Type:application/json" http://localhost:8888
     /people/{id}/cars/ -d '{"carId": someCarId}'

您还可以反转（或实现两者）关系并将人员添加到特定汽车：

POST /cars/{id}/persons/

curl -i -X POST -H "Content-Type:application/json" http://localhost:8888
         /cars/{id}/persons/ -d '{"personId": somePersonId}'