Restful api 特定过滤器的路由命名约定

Question

我在数据库中有一些 "Evaluation" 的外键可以为 "Category"

所以在标准休息路线中，我已经完成了这 2 条路线：

• GET /api/categories/{category_id}/evaluations（针对特定类别）

• GET /api/evaluations（对于有或没有类别的所有评估）

我的问题是关于没有类别的评估的 GET（名为 "basic" 评估），我应该如何命名它：

• GET /api/evaluations/basic
• GET /api/basic/evaluations
• GET /api/categories/evaluations
• GET /api/categories/basic/evaluations

?

Answer 1

鉴于 basic 听起来像评估类型，您可以通过查询字符串过滤来实现：

GET /api/evaluations?type=basic

这当然也可以扩展以支持更多过滤，以及排序或分页