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

[wusheng0]

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

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

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

比较好？

向各位前辈们请教一下。

[seth19960929]

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

[crclz]

第一个问题没看懂。

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

[wusheng0]

@seth19960929

@crclz

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

[xuanbg]

查询参数看需求呀。

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

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

[wusheng0]

@xuanbg
多谢解惑