Chuck1sn《你不知道的 Java》💘 什么是好的 Web Api 设计 (第二章) 中发帖

书接上文


查询的定义
依据上一章节内容的内容,REST LEVEL2 的查询只需要使用 GET 方法与 URI 定位到相应资源就可以了。但实际业务中查询往往涉及更复杂的细节处理,比如查询的参数。
查询参数
我们所说的查询参数是指在 http method 为 GET 的查询 api 中,使用 urlencode 的传参方式在 URI 的末尾 ? 后面添加的相应参数。




示例




api.linkedin.com/v1/people-search?first-name=Clair



如上所述,first-name 为你的查询参数对应的 key 值。通常我们会根据不同的业务信息,使用对应的 key 名称。不过,偶尔你也会看到下面这样的查询参数。




示例




api.instagram.com/v1/users/search?q=jack


api.insta...