为用户资源设计restful API

Question

我正在使用 Laravel 和 AngularJS 设计一个宁静的 API。我知道 RESTful API 的基础知识，但很难弄清楚为 user 资源设计它的最佳方法是什么。

让我们猜猜，用户可以拥有他的个人资料并可以更新个人资料。所以，URL 应该是这样的：

1. 对于用户资料查看：www.example.com/users/{id}
2. 用户资料更新：www.example.com/users/{id}/edit

但这些 URL 看起来很糟糕。漂亮的网址是：

1. 对于用户资料视图：www.example.com/profile
2. 用户资料更新：www.example.com/profile/edit

或

1. 对于用户资料查看：www.example.com/{username}
2. 用户资料更新：www.example.com/{username}/edit

我的问题是，如果我使用最后两个漂亮的 URL，它会破坏 restful API 原则吗？为 user 资源设计 API 的最合适方式是什么？

Answer 1

我认为您应该利用在RESTFUL api 中使用HTTP 动词的优势，这将使您的网址更具可读性：

`GET www.example.com/users/{id}` for profile retrieval
`PUT www.example.com/users/{id}` for profile update

您可以查看此博客以获取更多信息HTTP Verbs