什么是更好的REST API？ / car / {make} / {model} / drive OR / car / drive / {make} / {model}？

Question

我正在创建一个REST api并拥有以下示例API：

汽车可以

• 创建
• 删除
• 从动
• 作为给定make的模型数组返回
• 作为所有车辆的阵列返回

API采用什么格式？这有关系吗？

Answer 1

假设drive是动词，那么您需要/car/{make}/{model}/drive，因为您正在请求特定的资源来驱动。在这种情况下，您需要一辆制作{make}和型号{model}的汽车。一旦该资源被退回，您就可以“开车”。它

第二个没有意义，因为您在此之后指定了动词，然后是用于检索资源的属性。

顺便说一句，如果您正在努力寻求纯REST标准，我就不会使用＆＃39; drive＆＃39;作为API的一部分。您的REST API应执行HTTP操作，例如GET，POST，PUT。