将GET参数与AND组合的公约？

Question

我正在设计API，我希望允许我的用户将GET参数与AND运算符结合使用。最好的方法是什么？

具体来说，我有一个group_by参数传递给Mongo后端。我想允许用户按多个变量进行分组。

我可以想到两种方式：

?group_by=alpha&group_by=beta

或：

?group_by=alpha,beta

其中一个是首选吗？我已经查阅了一些API设计参考资料，但似乎没有人对此有所了解。

Answer 1

没有严格的偏好。第一种方法的优点是许多框架会将group_by转换为数组或类似结构，而在第二种方法中，您需要自己解析值。第二种方法也不那么冗长，如果您的查询字符串特别大，这可能是相关的。

您可能还希望使用第一种方法进行测试，即查询字符串始终按客户端发送的顺序进入您的框架。有些框架有一个不会发生的错误。