各位好，目前我使用 Laravel 当作 API Server 的开发，爬过很多关于 RESTful 的文章
，如果是 resource 确定的 crud 很容易处理，举例来说如果是使用者 > 文章 > 留言
controller name
UserArticleCommentController.php
网址会是 GET www.example.com/users/{user_id}/articles/{article_id}/comments
但常常会有规格外的东西就会比较苦恼，我知道这没有一定自己公司说好就可以遵守，但
还是想听听看有相关经验的朋友可以提供一下想法，下面开始举例。
场景一，建立 widget：
我今天要提供前端三只 API 资料给前端的 widget 用，像是 login-records、votes、
stars，这三个名称以及 widget 都没有所谓的 resource 概念，每一只都是多张表整理出
来的结果，那档案跟网址命名该怎么做才好。
1.1
WidgetController.php
function getLoginRecord()
function getVotes()
function getStars
1.2
WidgetLoginRecordController.php
function index()
WidgetVoteController.php
function index()
WidgetStarController.php
function index()
1.3
Widget/LoginRecordController.php
function index()
Widget/VoteController.php
function index()
Widget/StartController.php
function index()
如果以跟一般 RESTful resource 安排一样的话，会是 1.2，但这只 API 理论上都只有
index 这个 method，这样是否有点浪费资源。
另外是 url 应该用 widgets/login-records 还是 widget/login-records，widget 有多
只，但实际上他们不是像 users/{user_id} 这种从多个 users data 里面抽出某一笔的概
念。
场景二：复合式动作的命名
假设要订阅某个文章，他是拿 header 里的 token 找出 user，然后带入文章 id 后写入
pivot table 那该怎么命名。
2.1
ArticleController.php
function subscribe()
POST www.example.com/articles/{article_id}/subscription
还是应该更明确
2.2
ArticleController.php
function userSubscribe()
POST www.example.com/articles/{article_id}/user-subscription
场景三：特殊注况
以使用者密码为例，密码可能有重设密码、忘记密码
3.1
UserPasswordController.php
function reset()
users/password/reset
function forgot()
users/password/forgot
3.2
UserController.php
function resetPassword()
users/password-reset
function forgotPassword()
users/password-forgot
想请教各位会怎么选择。