api - 如何在遵守 REST 原则的同时传递任意数量的参数

Question

我有一个包含 3 个表的数据库：product、category和xref_product_category. 我的业务逻辑允许产品与任意数量的类别（床、浴室、厨房等）相关联。在设计 REST API 方面，建立这些关系的最佳方式是什么？

出于某种原因，我不愿将类别 ID 的 JSON 数组作为参数传递，但我真的没有充分的理由不这样做。我想另一种选择是进行一系列PUT调用，每次都传递一个参数。建立这样的多个关系的最 RESTful 方式是什么？这应该在单个 API 调用中完成，还是在多个调用中完成？

Answer 1

我会允许参数以任何顺序传递。

Answer 2

在 REST 中，短语“任意数量的参数”通常表示“表示”。

作为一个整体的参数最有可能组合成有效负载内容以表示资源。

因此，首先定义有效负载的模式，然后您将拥有一个可用于表示它的媒体类型。记录模式并告诉将使用 API 的人员他们可以使用该内容发布或放置来定义您的产品及其与其他资源的任意关系。

然后为您的资源定义 URI，product以及客户端如何从 Cool（入口点）URI 导航到它。