REST URI设计：具有复数名称的资源

Question

{
  "customerId" : "string",
  "accounts" : [{
    "accountId" : "string",
     ...
  }],
  "profiles" : [{
    "profileId" : "string",
     ...
  }]
}

我正在构建一个REST api，以提供对此资源和子资源的访问，如帐户和配置文件。

这是我提出的URI：

1. /customers/{id}/relationship-返回上述资源
2. /customers/{id}/relationships/accounts-返回accounts子资源
3. /customers/{id}/relationships/profiles-返回profiles子资源

Answer 1

如果'relationships'是一个单独的对象而不是一个集合，您可以使用几种方法。

1. 完全删除它，以便您拥有/customers/{id}/帐户和/customers/{id}/配置文件
2. 将其重命名为其他内容/customers/{id}/related/accounts
3. 保持原样...这仍然是因为“accounts”和“profiles”成为Relationship集合下面的id（/customers/{id}/relationships/{id（accountsprofiles）}

遵循标准总是好的。但通常你会花太长时间担心一些小问题，这些小问题最终无论你走哪条路，都不会产生很大的影响。