api 设计时，使用"用户 id（unique）"还是用主键_id 作为查询参数？

V2EX = way to explore

V2EX 是一个关于分享和探索的地方

现在注册

已注册用户请登录

这是一个创建于 1454 天前的主题，其中的信息可能已经有所发展或是发生改变。

不是专职后端，最近在写 api 时很纠结这个。

此外，返回 json 时，应该直接返回{ 全部字段 },还是

{
  info:{
    name:{},
    email:{}
  },
  posts:{
    articles:{},
    comments:{}
  }
}

比较好？

向各位前辈们请教一下。

5 条回复 • 2020-11-15 17:38:55 +08:00

seth19960929

2020-11-15 14:38:33 +08:00 via Android

简单就第一种全部字段展开
字段多就嵌套，没什么好想的

crclz

2020-11-15 15:28:16 +08:00

第一个问题没看懂。

第二个问题，当然是嵌套好。你把嵌套的给打平后，不就熵增了吗？（人不会平白无故去把杯子摔碎吧）
如果是嵌套的，那么有利于前端组件的复用。

wusheng0

2020-11-15 16:44:15 +08:00 via Android

@seth19960929

@crclz

谢谢回复。
第一个问题意思是，主键和唯一的用户名，实践中哪个作为查询参数比较好。
users/:id，还是 users/:name 。

xuanbg

2020-11-15 17:27:02 +08:00

查询参数看需求呀。

如果直接查用户信息的，你非要用 id 人家就没法查了呀。使用者只知道姓名手机号什么的，哪里记得你 id 是多少呢。

间接查询的话，譬如查 xx 人的订单，可以先根据姓名查出 id，然后用 id 去查订单。好处是不需要联表查询，可以提高查询效率。

wusheng0

2020-11-15 17:38:55 +08:00

@xuanbg
多谢解惑