RESTURI约定-创建资源时的单数或复数名称怎么弄?

内容来源于 Stack Overflow,并遵循CC BY-SA 3.0许可协议进行翻译与使用

  • 回答 (10)
  • 关注 (0)
  • 查看 (227)

我对REST很陌生,我注意到在一些RESTful服务中,它们使用不同的资源URI来更新/获取/删除和创建。如

  • 创建-使用/resources用POST方法(观察复数)在某些地方使用/resources(单数)
  • 更新-使用/resources/123用放法
  • 利用/resources/123用GET方法

我对这个URI命名约定有点困惑。我们应该使用什么复数或单数来创建资源?

提问于
用户回答回答于

从API使用者的角度来看,端点应该是可预测的,所以

理想情况下.

  1. GET /resources应该返回资源列表。
  2. GET /resource应该返回一个400级别的状态代码。
  3. GET /resources/id/{resourceId}应该使用一个资源返回集合。
  4. GET /resource/id/{resourceId}应该返回一个资源对象。
  5. POST /resources应该批处理创建资源。
  6. POST /resource应该创建一个资源。
  7. PUT /resource应该更新资源对象。
  8. PATCH /resource应该只发布更改的属性来更新资源。
  9. PATCH /resources批处理更新资源时,只发布更改的属性。
  10. DELETE /resources应该删除所有资源;只是开玩笑:400状态代码
  11. DELETE /resource/id/{resourceId}

这种方法最灵活,功能最丰富,也是开发时间最长的方法。因此,如果您很匆忙(软件开发总是如此),只需指定端点resource或复数形式resources我更喜欢单数形式,因为它让你可以选择以编程的方式进行反思和评估,因为并非所有的复数形式都以‘s’结尾。

尽管如此,出于任何原因,最常用的实践开发人员选择的是使用复数形式。这是我最终选择的路线,如果您看一下流行的API,比如githubtwitter他们就是这么做的。

决定的一些标准可以是:

  1. 我的时间限制是什么?
  2. 我将允许我的消费者做什么操作?
  3. 请求和结果有效负载是什么样子的?
  4. 我希望能够在代码中使用反射并解析URI吗?

所以这取决于你。不管你做什么都是一致的。

热门问答

我刚申请的服务器,缺省给我的是linux,可我要Windows,怎么办?

蒋小爱

腾讯云 · 技术支持 (已认证)

推荐
云服务器提供 不同平台重装:仅支持中国大陆地区(不含中国香港)。 例如,Linux 重装为 Windows,Windows 重装为 Linux 。 参考 重装系统: https://cloud.tencent.com/document/product/213/4933 图片.p...... 展开详请

在小程序开通直播功能,是不是还需要业务去申请直播的证书?

推荐
腾讯云有商业直播方案(提供小程序直播插件),客户通过直播插件实现直播业务(不需额外提供直播资质) 插件对接条件: 客户小程序类目为“电商平台”或“在线教育” 所以就是说, 只要用了腾讯云的小程序直播方案, 小程序的类目为 “电商平台” 或“ 在线教育”, 就可以。只要自身业务不...... 展开详请

腾讯云 TRTC 互动直播 云直播 商业直播区别是什么?

人生的旅途辣鸡前端
推荐
云直播:腾讯云的直播云端处理分发平台 移动直播:腾讯云提供的直播推拉流集成的sdk(iOS、Android、小程序) 互动直播:云直播(云端)+移动直播(终端)+连麦功能 商业直播:基于云直播的直播小程序插件(SaaS腾讯云提供页面模板,PaaS客户自己开发) 商业直播和移动直播...... 展开详请

关于ti-one平台问题?

腾讯智能钛AI开发者

腾讯云 · 智能钛产品团队 (已认证)

腾讯智能钛产品团队官方运营账号。分享产品最新动态,第一时间解答用户疑问。
推荐
您好,感谢您的提问。 TI-ONE平台里的任务是运行在Linux系统上的; 目前TI-ONE工作流任务暂不支持实时查看显存使用情况,notebook任务可在右侧资源栏查看; TI-ONE已上线计费,但目前试运营阶段限时0折。试运营阶段结束,正式开启收费前会提前通知用户定价变动,还...... 展开详请

合作伙伴学院里的学习视频测试题和在线培训系统里的测试题能否提供答案?

骑牛看晨曦love&peace~
推荐

http://tencentcloudxuexi.com 合作伙伴可以登录此平台做练习题,有答案的喔

云服务器不能访问外部网站?

HappyLau谈云计算

腾讯云 · 云计算高级工程师 (已认证)

专注于公有云,私有云解决方案,在kubernetes,openstack,kvm,ceph,linux,shell有丰富的实战经验。
推荐
不能访问外部网站一般是网络和dns的问题,按照如下步骤排查: 1. 确保CVM有外网ip或者NAT转换,使用ping测试下外网的连通性,如果不通请购买弹性公网IP,先申请后购买参考https://cloud.tencent.com/document/product/215/201...... 展开详请

所属标签

扫码关注云+社区

领取腾讯云代金券