REST API设计：GET请求能否返回动态扩充的资源列表？

核心结论 #

你当前的设计完全符合RESTful API规范，无需额外新建独立资源。

合规依据 #

• REST架构从来没有约束同一个资源路径只能返回固定Schema的响应，查询参数的核心作用之一就是自定义资源的返回表现形式。你当前的GET /customers?letters=ry请求，本质是请求客户集合资源附加匹配次数统计的特定表现形式，没有脱离/customers对应的客户集合资源的核心定义。
• 请求完全符合GET方法语义：整个操作是只读的、满足幂等性要求，没有修改服务端的任何资源状态，符合GET方法的使用规则。
• 动态计算的附加字段不属于REST规范的约束范畴：REST只要求资源的标识（路径+查询参数）和响应对应，不会要求响应内容必须和后端持久化的资源Schema完全一致。

什么场景需要拆分独立资源 #

只有当你需要实现的功能和原有Customer资源的核心含义完全无关，或者需要对统计逻辑本身做独立的增删改操作（比如持久化统计规则、保存历史统计结果）时，才需要单独新建/ratedCustomers或/customer-match-statistics这类独立资源，你当前的场景完全不需要拆分。

可选优化建议 #

如果担心和原有无统计字段的Customer列表响应冲突，可以做两种优化：

• 加显式的字段控制参数：比如GET /customers?letters=ry&include=matchCount，用include参数明确要求返回附加的统计字段，语义更清晰
• 用内容协商区分：客户端传递Accept: application/vnd.你的企业标识.customer-with-match-count+json时返回带count字段的响应，否则返回原有格式，方便多版本兼容。

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