具有用于获取剩余请求的查询参数的混合路径参数？

Question

我有这样的路径：

 GET http://aaa.com/invoices/{someType}/<bunch of optional query parameters>

在rest api中将路径参数与常规查询参数混合可以吗？还是更好地使用所需的查询参数，也许有更好的方法？

Answer 1

是否可以在rest api中将路径参数与常规查询参数混合？

是。 REST不在乎您对资源标识符使用什么拼写-符合RFC 3986描述的生产规则的任何拼写都可以。编码为URI的信息是由服务器自行决定并供其使用的。

从通用客户端的角度来看，标识符是整个URI。

/a/b/c/d
/a/b/c/d?hasOptionalParameter=true

就REST而言，这是两个different标识符，因此是两个different资源。您为他们拥有一个端点是一个实现细节。

URI Templates允许您描述“通过变量扩展的一系列统一资源标识符”。通用模板支持在路径段和查询部分上的变量扩展。

但是：最熟悉的URI模板之一是HTML表单；表单操作的查询部分的GET perform a replacement的处理规则，但路径段保持不变。实际上，客户端可以保护表单操作URI的路径部分不被更改，但查询部分将被更改。