Met*_*uru 4 api url http naming-conventions
只是好奇,但我正在制作一个API,到目前为止使用这样的URL:
/用户/创建
/用户身份]
现在我正在补充
/用户/创建/批
这让我想知道是否有任何理由我应该将用户管理端点称为"用户",而不仅仅是"用户".然后,也许它根本不重要.我至少会猜测我应该对此保持一致.
思考？
我几乎总是在我的网址设计中使用复数.我总是想到在我的网址路径中导航,类似于目录,我越来越深入.
有一个顶级资源(如/users)表示一个集合,有一些子资源(如/users/{userId}/items)本身就是一个集合.
到目前为止,我所见过的所有api及其代表域都符合上述建议.
关于你提到的/users/create/batch外观,你想在url中编码一个'action'.在基于HTTP的宁静设计中,如果您使用HTTP方法POST /users(单用户有效负载)或者用于传输多个用户的批量创建模式,则更适合.在您的情况下,"创建"和"批次"意味着什么？