在处理不同类型的GET时，应该如何格式化REST API

Question

假设我拥有并订购了资源。为了获得我想要的资源，我会这样做：

GET /orders/{someId}

问题是，当存在不同类型的get时，我该怎么办。例如，获取以编辑订单或获取以查看订单。通常，您只需对这两种类型使用订单/{someId}，但在这种情况下，我需要为每种类型执行一些不同的业务逻辑（一些审计）。

也许我可以这样做：

GET /orders/{someId}?type=review

但这似乎是错误的。思想？

Answer 1

根据正在发生的操作，可以使用不同的HTTP方法（作为动词）。这将允许您保持路径干净和简单。

示例：

GET /orders/{someId}
PUT /orders/{someId}
POST /orders/{someId}
DELETE /orders/{someId}

GET用于检索、放置以更新、发布以创建和删除资源。这遵循基本CRUD（创建、读取、更新、删除）。如果需要添加任何其他过滤器/参数，请使用查询参数。

Answer 2

GET /orders/{someId}/action

满足您的需求

GET /orders/{someId}/edit
GET /orders/{someId}/review

GET不应该修改该项目，所以我假设这个URL只是为了加载资源，而不是为了修改它。。。。请澄清这一点