针对类别

Question

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

- root_category
   - sub_category
      - product1
   - product2
- product3 

在此示例中，root_category包含sub_category＆amp; product2。 subcategory包含product1。 product3不属于任何类别。

以下是可能的用例：

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

/products

1. 按ID获取产品详情。

/products/{id}

1. 按ID，名称或说明搜索产品（需要按照这些标准之一进行查询）

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

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

/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。

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

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