RESTful 子类型资源

Question

一个最佳实践问题。如果您正在设计 RESTful 接口(interface)，您将如何区分子类型。例如。您的应用程序有动物(每只动物由其animalId 标识)具有狗和鸟的子类型，其中每个子类型都有其特定的子资源。例如。狗有尾部长度和鸟翼长度(不管它是什么)。您会选择这些(或者您有更好的方法)中的哪一个？

1)
/animals/{animalId}/tail-length (400 when animal is bird)
/animals/{animalId}/wings-length (400 when animal is dog)

2)
/dogs/{animalId}/tail-length
/birds/{animalId}/wings-length

3)
/animals?type=dog/{animalId}/tail-length
/animals?type=bird/{animalId}/wings-length

Answer 1

假设不同子类之间没有 ID 勾结，我会推荐以下方法。
GET /animals/:id
有了这样的回应。 (这个例子是 JSON，但也可以很容易地是 XML/etc)

{
  "id": "xyz",
  "type": "dog",
  "tailLength" 400
}

这使它保持简单和 RESTful。