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指向同一个资源是完全可以的。但更重要的是，确保资源包含 元素，这些元素将节目连接到网络，将剧集连接到节目等。