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

V2EX = way to explore

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

已注册用户请登录

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

在设计一个网站的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的设计规范吗？

请各位不吝指教。多谢！

rest

API

21 条回复 • 1970-01-01 08:00:00 +08:00

binux

2013-07-31 15:42:24 +08:00

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

jasontse

2013-07-31 15:44:29 +08:00 via iPad

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

justfindu

2013-07-31 16:24:31 +08:00

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

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

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

所以一个参数更加醒目.

leofml

2013-07-31 17:35:52 +08:00

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

我猜是框架问题

davepkxxx

2013-07-31 17:51:49 +08:00

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

BeijingBaby

2013-07-31 17:55:58 +08:00

@justfindu 可以接收到多个值。

whuhacker

2013-07-31 19:16:35 +08:00

我觉得你应该用 ?search=

sharpnk

2013-07-31 21:18:21 +08:00

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

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

zorceta

2013-07-31 21:20:30 +08:00

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

catsky

2013-07-31 21:44:55 +08:00

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

hourui

2013-07-31 22:09:48 +08:00

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

whuhacker

2013-07-31 22:39:48 +08:00

同意逗号，见过这样用的

pright

2013-07-31 22:40:48 +08:00

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

RobinFai

2013-08-01 08:59:23 +08:00

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

justfindu

2013-08-01 09:05:47 +08:00

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

duhastmich

2013-08-01 09:25:12 +08:00

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