REST规范下多场景客户API端点的正确命名方式咨询

你的第一种REST设计完全符合REST规范，没必要改成第二种结构，理由如下：

• 资源定位的核心逻辑：/customers代表客户集合资源，查询参数（比如?status="nonPayers"）的作用是对这个集合做筛选过滤，这是REST风格API的标准操作方式。分页、多条件筛选这类场景几乎都是用查询参数实现的，属于行业通用做法。
• 路径变量的正确用法：路径变量（比如/customers/{id}）适合用来标识唯一的子资源——每个id对应一个确定的单个客户，这是集合下的独立资源，用路径变量定位完全合理。但状态是筛选条件，不是独立资源，同一个状态对应多个客户，把它放到路径里会混淆“资源”和“筛选条件”的边界。
• 扩展性与简洁性：第二种设计会导致端点冗余膨胀。如果后续要加按姓名、地区筛选，难道要挨个新增/customers/byName/{name}、/customers/byRegion/{region}？而查询参数可以灵活组合，比如/customers?status="nonPayers"&region="north"，扩展性更强，API结构也更简洁。
• 语义清晰度：/customers?status=xxx的语义是“从客户集合中筛选出状态为xxx的子集”，完全贴合REST“围绕资源设计”的理念；而/customers/byStatus/xxx更像“执行一个按状态查询的操作”，违背了REST强调资源而非操作的核心原则。

另外，/customers/{id}的设计本身就很合理，没必要改成/customers/byId/{id}，这种写法纯属画蛇添足，增加了不必要的路径层级。

内容的提问来源于stack exchange，提问作者fckNewbee