【问题标题】：Path parameters or Request parameters - from client perspective路径参数或请求参数 - 从客户端的角度
【发布时间】：2013-08-28 06:02:50
【问题描述】：
我正在为 RESTful API 开发一个 Web 客户端。假设已经公开了两种类型的 API（用于同一任务）。
- 作为 URL 路径一部分的参数（即 /api/resource/parametervalue ）
- 作为查询参数的参数（即 /api/resource?parameter=value ）
从网络客户端的角度来看，您能否建议我两者中哪个更好以及为什么。
【问题讨论】：
标签：
javascript
json
api
web
query-parameters
【解决方案1】：
选项 2 是要走的路。如果您的参数不是资源，则它们没有理由成为端点。它只会让你的 API 变得混乱。如果你有两个或三个或十个参数怎么办？客户应该记住他们进入的确切顺序吗？如果他们只想指定参数 2、3 和 7 怎么办？您真的要编写后端来准确确定调用应该是什么吗？
【解决方案2】：
我认为最好使用第二个选项 - 作为查询参数。我的意见基于：
- 这是 HTTP 的标准形式，用于处理 GET 请求。
- 易于解析的键\值样式。