如何为 HTTP GET 的多个 Key-Value 参数设计 REST URI

我正在设计一个 RESTful API。

一项服务应该提供多个键值对的查询功能。例如，客户端可以使用一个 HTTP GET 请求来查询不同的产品及其关联的数量。

客户想要查询金额为 44 的产品 1 和金额为 55 的产品 2。 我实际上不希望我的 URI 看起来像这样：

/produkt?productId1=1&productquantity1=44&productId2=2&productquantity2=55

因为我不知道查询了多少产品。

或者像这样：

/produkt?product=1,44&product=2,55

因为客户端怎么知道逗号之前是productId，逗号之后是数量。

有人有其他解决方案吗？或者通过一个请求提供查询多个产品的可能性不是 RESTful 吗？提供仅查询一种产品及其相关数量的可能性是否更好，如果客户想要查询更多产品，他们应该发送更多请求？

这是传递参数的一种想法：

/products?productDetail=[{"key":"key0","value":"key1"},{"key":"key2","value":"key2"},{"key":"key3","value":"key3"}]

where

[{"key":"key0","value":"key1"},{"key":"key2","value":"key2"},{"key":"key3","value":"key3"}]

是一个 JSON 表示List<kv> class

class kv {
    String key;
    String value;


    public kv(String key, String value) {
        super();
        this.key = key;
        this.value = value;
    }

    public String getKey() {
        return key;
    }

    public void setKey(String key) {
        this.key = key;
    }

    public String getValue() {
        return value;
    }

    public void setValue(String value) {
        this.value = value;
    }

}

这样您就可以轻松转换查询参数productDetail in to List<kv> using

new Gson().fromJson(productDetail,kv.class);

您可以轻松地迭代所有元素。

另一个建议是，如果您不知道查询了多少产品，则使用POST对此提出要求。