webapi中URI和函数定义问题

[dongshanyu]

WebApiConfig 使用默认路由：
config.Routes.MapHttpRoute(
name: "DefaultApi",
routeTemplate: "api/{controller}/{id}",
defaults: new { id = RouteParameter.Optional }
);

1 资源为book
1.1 获得编号为123456书籍信息
URI:/api/books/123456
函数:Get(string id)
1.2 获得编号为123456书籍的所有评论
URI:/api/books/123456/comments
函数:？
1.3 获得编号为123456书籍的作者信息
URI:/api/books/123456/author
函数:？
2 资源为comment
2.1 获得编号为123的评论
URI:/api/comments/123
函数:Get(string id)
2.1 获得编号为123456书籍的所有评论
URI:/api/comments?bookid=123456
函数:？

想知道上面的1.2/1.3/2.1的URI设置是否合适？对应的函数该如何创建？

[丰云]

不合适

以1.2为例，下面这样写比较合理：

URI:/api/comments/123456
函数:Get(string id)

[丰云]

另外，实际应用中要考虑版本问题，因此，一般都应该在api后面跟一个版本号，比如：

api/v1/books/123

[dongshanyu]

引用 1 楼 foren_whb 的回复:

不合适

以1.2为例，下面这样写比较合理：

URI:/api/comments/123456
函数:Get(string id)

1 这样设置是否会和2.2混淆？实际变成"获得编号为123456的评论"，而非"获得编号为123456书籍的所有评论"
2 路径中增加版本号的问题，之前网上也有看到有人提过，未将来变更考虑，的确有必要

[dongshanyu]

上面说错了，是和2.1混淆

[正怒月神]

使用restful风格，那就遵守他的规则嘛。
URI:/api/books/123456
URI:/api/comments/123
URI:/api/comments?bookid=123456

这三个都可以

[dongshanyu]

To 正怒月神

若使用restful风格，按如下设置是否正确？

1 资源为book
1.1 获得编号为123456书籍信息
URI:/api/books/123456
函数:Get(string id)
1.2 获得编号为123456书籍的所有评论:用2.2替代
URI:/api/books/123456/comments
1.3 获得编号为123456书籍的作者信息:用3.2替代
URI:/api/books/123456/author
2 资源为comment
2.1 获得编号为123的评论
URI:/api/comments/123
函数:Get(string id)
2.2 获得编号为123456书籍的所有评论
URI:/api/comments?bookid=123456
函数:GetCommentsByBookID(string bookid)
3 资源为authors
3.1 获得编号为abc的作者信息
URI:/api/authors/123
函数:Get(string id)
3.2 获得编号为123456书籍的作者信息
URI:/api/authors?bookid=123456
函数:GetAuthorsByBookID(string bookid)