RESTful API URI设计

Question

我正在寻找关于RESTful API的URI设计的一些方向.我将有几个嵌套的链接资源,目前我的URI设计类似于这篇文章:分层RESTful URL设计

以下示例不是我正在构建的,但我认为很好地说明了我的情况.(假设一个节目只能属于一个网络).

/networks [GET,POST]
/networks/{network_id} [GET,PUT]
/networks/{network_id}/shows [GET,POST]
/networks/{network_id}/shows/{show_id} [GET,PUT]
/networks/{network_id}/shows/{show_id}/episodes [GET,POST]
/networks/{network_id}/shows/{show_id}/episodes/{episode_id} [GET,PUT]

我的情况将进一步增加两个级别的协会,但所有的协会是一对多.我正在考虑将其切换为类似的东西:

/networks [GET,POST]
/networks/{network_id} [GET,PUT]
/networks/{network_id}/shows [GET,POST]

/shows [GET]
/shows/{id} [GET,PUT]
/shows/{id}/episodes [GET,POST]

/episodes [GET]
/episodes/{id} [GET,PUT]

我的问题是:

1. 第二个例子是有效的REST设计吗？
2. 我应该考虑实施两条路径吗？

Answer 1

第二个例子对我来说很好看.URL描述了资源,并且正在使用正确的HTTP谓词.

如果有意义的话,将多个URL指向同一资源是完全正常的.但更重要的是,确保资源包含<link />将节目连接到网络,剧集到节目等的元素.