REST API查询参数命名疑问：是否可用复数？多值参数如何命名？

1. 能否在REST API的查询中使用复数命名？ #

当然可以！在REST API设计里，复数命名不仅完全允许，还属于很普遍的实践。毕竟很多场景下我们查询的本来就是一组资源，用复数参数名能让语义更直观。比如你要拉取多个订单的详情，用GET /orders?status=shipped就比单数order更容易让人一眼明白——这个参数是和多个订单相关的。

2. 发送一组client ID时，参数该用"client"还是"clients"？有没有行业规范？ #

行业里并没有绝对强制的规范，但有一些被广泛认可的实践，咱可以结合场景来选：

• 用复数clients：这是更贴合语义的选择，明确告诉调用者这个参数接收的是多个client ID。比如请求可以写成GET https://somedomain.com/some/endpoint?clients=1&clients=2，或者更简洁的clients=1,2（大多数后端框架都支持解析这种逗号分隔的列表）。优点是可读性拉满，看到参数名就知道是多值，完全不会有歧义。
• 用单数client：这种方式也很常见，很多HTTP客户端和后端框架默认支持同一个参数名重复传值，后端会自动把它们解析成一个数组。好处是如果你的资源路径用了单数（比如/client），参数名和路径保持一致会显得更统一，但缺点是刚接触的开发者可能会困惑“为什么要传两次client？”

如果要选更稳妥、更符合REST设计原则的方案，我个人推荐用复数clients——毕竟REST是面向资源的，你请求的是多个client相关的数据，复数参数名能直接体现这一点，减少沟通和理解成本。

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