设计REST API: 一个REST api里面传递多个同名参数合理吗

[catsky]

在设计一个网站的REST API，碰到一个问题，想听听大家的意见，多谢。

比如：一个用来获取用户信息的REST api

http://www.mydomain.com/users?name=ken&name=kerry&name=Chris

这样，传递三个name参数，可以只调用一次，就可以获取这三个用户的信息。但是我看了很多网站暴露的REST API， 如sinaapp，weixin 等，对于此类的REST API， 只允许提供一个name参数，如果需要这三个用户的信息，需要调用三次
http://www.mydomain.com/users?name=ken
http://www.mydomain.com/users?name=kerry
http://www.mydomain.com/users?name=Chris

我觉得这样这样效率有点低，但sinaapp等为什么会这样设计呢？ 这是REST api的设计规范吗？

请各位不吝指教。多谢！

[binux]

同名的参数表达的是数组
name = [ken, kerry, Chris]
然后该怎么用，自己考虑

[jasontse]

提高请求数有利于新浪收费 :D

[justfindu]

你传三个name 也只会接收到最后一个呀~ 有和区别~

微信 新浪等没有太大需求来请求list类型的

还有如果是传递三个参数只调用一次, 数据库操作消耗和单个的应该没多少区别~ 无非是 or 和 in 吧

所以一个参数更加醒目.

[leofml]

express的话, 对于第一个api, req.body.name = [ken, kerry, Chris]

我猜是框架问题

[davepkxxx]

普通的数组而已，没有什么合理不合理的。

[BeijingBaby]

@justfindu 可以接收到多个值。

[whuhacker]

我觉得你应该用 ?search=

[sharpnk]

http://www.mydomain.com/users?name=ken&name=kerry&name=Chris
这样，传递三个name参数，可以只调用一次，就可以获取这三个用户的信息。

?? how? 你三个参数的名字都一样, 服务器端能读到的应该只有ken或者是chris. 读到哪一个取决于框架的设计.

[zorceta]

http://www.mydomain.com/users?name=ken&&kerry&&chris
@jasontse +1

[catsky]

@zorceta name=ken&&kerry&&chris 这样的话，在服务器端获取参数 name的值ken&&kerry&&chris， 然后代码split这个string？ 用&&是应该规范？还是用其他的连接符也可以，比如逗号?name=ken,kerry,chris

[hourui]

http://www.mydomain.com/users?name=ken,kerry,Chris
为何不这样写
或者找一个特殊的分隔符做分割不就好了？

[whuhacker]

同意逗号，见过这样用的

[pright]

http://stackoverflow.com/questions/2602043/rest-api-best-practice-how-to-accept-as-input-a-list-of-parameter-values

[RobinFai]

http://www.mydomain.com/users?name[]=ken&name[]=kerry&name[]=Chris
btw，数组不是这样传的？

[justfindu]

@BeijingBaby 我知道可以多值~ 但是没有 name=***&name=***&name=*** 这样传值吧~ 但是理论上也是可以获取~ 使用query模式获取uri~ 但是这样不觉得很反常么~

[duhastmich]

@leofml get请求没有body的吧, 因该是req.param('name')
不过标准的应该是 name[]=foo&name[]=bar, name=foo&name=bar 解析应该是express 额外做的吧, 可能也有其他框架这么做, 这样name 是string 还是 array..
还是逗号分隔比较好看

[soli]

http://www.mydomain.com/users?params=Base64过的JSON

Base64之前的JSON:

{
"name":["xxx","yyy","zzz"],
"other":"xxoo"
}

这样可行不？

[zorceta]

@catsky 随手写的>_<
逗号可能更好看

[zorceta]

@catsky 另外&&是C里的and

[undeadking]

REST强调资源,你这样设计,user就不算资源了.
以复数的用户作为资源的话,post,put和delete对应的操作也是批量化的,这样的场景很少