我对REST架构相对较新,我对如何为我的项目实现我的RESTful API有一些疑问。
哪些 URI 和资源适用于:
1. 登录和注销?
我猜:POST or DELETE /api/users/auth
还是POST or DELETE /api/users/login
?
2. 设置、删除或获取用户的头像?
我猜:POST or DELETE or GET /api/users/{id}/avatar
. 正确吗?
3. 通过发送的代码进行验证?
我猜:POST /api/users/{id}/verification
. 正确吗?
4. 更改用户的单个或某些特定属性?(例如更改电子邮件或用户名(
我猜:PACTH /api/users/{id}
还是PUT /api/users/{id}/email
.正确吗?
提前谢谢。
1. 登录和注销?
对于 Web API,您必须实现 OAuth 授权,然后使用
POST /oauth
获取令牌
2. 设置、删除或获取用户的头像?
没有具体的规则,但人类应该能够轻松阅读和构建URL。所以,我认为会没关系
的POST or DELETE or GET /api/users/{id}/avatar
3. 通过发送的代码进行验证?
这取决于你。
4. 更改用户的单个或某些特定属性?(例如更改电子邮件或用户名(
在这里,我建议将PACTH /api/users/{id}
与 json body 一起使用来部分更新或PUT /api/users/{id}
到完全更新用户。看看这个包
您可以阅读Microsoft REST API 指南以了解更多详细信息。