URL 在依赖集合上创建的对象的地址

Question

我们正在创建一些 REST API 文档。有些地方对公司造成打击。所以我们在以下路径创建了一个动作：

/company/{companyId}/locations

对我来说这是合乎逻辑的，我认为它符合 REST 的要求：

/company/{companyId}/locations/{locationID}

它应该 return 位置的一个实例，因为我已经在那里创建了它。

但我的后端程序员坚持认为这不方便，因为他必须在每次调用时获取公司对象。他说我应该在以下位置执行 GET、PUT 和 DELETE 操作：

/locations/{locationID}

如何让他相信拥有URL凝聚力是个好主意？

Answer 1

我认为您的程序员是对的，您应该向响应添加超链接，而不是构建对客户端无意义的嵌套 URI 结构。详细了解 HATEOAS 和统一接口约束。