类别的电子商务REST API

Question

在我的电子商务项目中，我正在构建一组REST API，以列出目录管理系统中的类别和产品。 类别可以具有子类别，产品可以属于一个类别或独立存在。

- root_category
   - sub_category
      - product1
   - product2
- product3 

在这里，在这个例子中， root_category包含sub_category及product2 。 subcategory包含product1 。 product3不属于任何类别。

以下是可能的用例：

1. 列出系统中的所有产品。

/products

2. 通过ID获取产品详细信息。

/products/{id}

3. 通过ID，名称或描述搜索产品（需要通过以下条件之一进行查询）

/products?searchTem={searchTerm}&q=[byId|byName|byDescription]

4. 列出系统中的所有类别。

/categories

5（a）。 列出属于特定类别的子类别。

/categories/{id}/categories

5（b）。 列出根级别类别。 （例如root_category ）。

/categories/@root/categories

6（a）。 列出属于某个类别的产品。

/categories/{id}/products

6（b）。 列出不属于任何类别的产品。 即根级产品（例如product3 ）。

/categories/@root/products

请让我知道您的评论，并建议对上面列出的这些REST URI进行改进。 我有点担心5（b）和6（b）。可以更好地设计这些URI。

Answer 1

我认为这看起来很合理，我唯一的问题是类别ID的使用。

我希望看到使用的类别名称，这对用户更友好。

类别名称显然必须是唯一的。