在restful api中,对于关联的查询应该使用什么id和什么样的描述?
一个关联,比如说用户的某篇收藏文章,可以立马想到的是这个api的URL大概是这种形式
/api/users/{userId}/fav-articles/{id}
那么在这个URL中,id这个参数应该使用谁的id?
是用户-收藏文章这个关联表的id,还是文章的id?
并且,应返回的描述是这个关联,还是这篇文章?
如果是这个关联,那返回的应该只有两者的id以及比如收藏时间等的关联的信息。
而返回这篇文章的话,那就是文章标题、内容等信息了。
或者说两者都应该返回,那形式又应该如何呢?是嵌套还是并列?
如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱,如果其他用户或者作者回复了您的评论,将不能在第一时间通知您!
发布评论
评论(2)
文章是某个用户收藏(自己只能看自己收藏)的,所以是某个用户下的资源。
一般情况下不会返回关联的资源。做法有两种:
GET /api/articles/文章ID
读取文章GET参数with
我之前在慕课网有篇课程详细讲解了
Restful API
的设计流程,干货满满,有需要可以去看看https://www.imooc.com/learn/811新建表 FavArticle - id, userID, articleID.
打开用户收藏的文章列表:
/api/fav-articles/{userID}
然后文章列表某篇文章的连接地址
/api/articles/{articleID}