首页   注册   登录
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
V2EX  ›  PHP

REST API 中,同一个参数多个值,正确的传递姿势是怎样的?

  •  
  •   jasonyang9 · 222 天前 · 3832 次点击
    这是一个创建于 222 天前的主题,其中的信息可能已经有所发展或是发生改变。

    比如要获取 2 本书的信息:

    GET http://server/books?id=1001&id=1002
    GET http://server/books?id=1001,1002
    GET http://server/books/1001/1002           这个肯定不对了
    

    当然用 POST 配合 JSON 值过去应该是不符合语义的。

    所以正确的姿势是怎样的?服务器端又应该如何获取这些值?

    41 回复  |  直到 2018-09-26 16:45:51 +08:00
        1
    syh   222 天前
    试下这样 http://server/books?id=1001_1002
        2
    mnssbe   222 天前
    id 放个 json
        3
    Mutoo   222 天前   ♥ 1
    ?ids[]=1001&ids[]=1002
        4
    linxl   222 天前   ♥ 1
    ?id[]=1&id[]=2
        5
    l12ab   222 天前 via iPhone
    id[]=1001,1002
        6
    ChoateYao   222 天前   ♥ 1
    如果是 PHP 的话,直接使用 id[]=1&id[]=2 即可。
        7
    l12ab   222 天前 via iPhone   ♥ 1
    不好意思,打错了,正确的见 3 楼 4 楼
        8
    chinvo   222 天前 via iPhone
    符合 http 的用数组,或者用逗号分隔
        9
    tanszhe   222 天前
    ids=[1,2,3,4,5,34,……]
        10
    broadliyn   222 天前   ♥ 1
    ids=1,2,3,4 不就好了。
    Restful Api 只是一种 Api 风格,不是强制规范。你完全可以选择性选择自己觉得有用的建议风格。
    没必要奉为圭臬。
        11
    Mutoo   222 天前   ♥ 1
    @Mutoo 这种写法的 querystring,PHP 可以直接支持,但并没有出现在任何的 RFC 规范中,其它语言的后端需要自行解析。
        12
    gouflv   222 天前 via iPhone
    GET http://server/books/1001,1002
        13
    fighterlyt   222 天前
    url 长度是有限的,而参数是无限的,所以出现在 URL 中的批量参数,都是有局限的
        14
    gaius   222 天前   ♥ 1
    前两种就是 int[]接收
        15
    stzz   222 天前   ♥ 2
    我来个绝对 restful 的方法,
    请求两次
        16
    GuryYu   222 天前   ♥ 5
    POST http://server/books/list
    Body 里面用 JSON 传过滤参数
    可以理解成创建一个 books 的临时列表资源, 列表的过滤参数来自 BODY, 并直接返回该资源
        17
    ylcc   222 天前
    三个字,随便弄,只要你的后端能解析
        18
    fighterlyt   222 天前
    @GuryYu 看了这个多回复,只有你的说法还是比较合理的,其他都完全不考虑 URL 长度问题
        19
    vicvinc   222 天前
    /books?include=author&book[]=1001,1002
        20
    vicvinc   222 天前
    @l12ab 正解
        21
    90safe   222 天前
    无论是 POST 还是 GET,都可以用:id[]=1&id[]=2 这样的类型传递。也可以:id=1001,1002 然后接收端分割成数组。
        22
    jasonyang9   222 天前
    多谢各位。我再捣鼓捣鼓
        23
    zhzer   222 天前 via Android
    随便选个分隔符不就完事?
        24
    isayme   222 天前
    有的服务端支持 id=1001&id=1002, 有的支持 id[]=1001&id[]=1002, 也有的都支持.
    主要是看你们服务端的支持情况.
    http://httpbin.org/get?a=1&a=2&b[]=3&b[]=4
    https://httpbin.isayme.org/anything?a=1&a=2&b[]=3&b[]=4

    或者直接改用 POST 方法?
        25
    fighterlyt   222 天前
    @jasonyang9 别听那伙人瞎比比,URL 长度的限制必须考虑,所以最安全的方法就是 POST
        26
    wunonglin   222 天前
    ?id=1001,1002
        28
    rogwan   222 天前 via Android
    一般的做法是逗号分隔
        29
    SorcererXW   221 天前
    一般来说用逗号分隔问题不大, 比如 stackexchange 的 api 设计: https://api.stackexchange.com/docs/answers-by-ids
    也可以考虑 http batch requests, 可以参考看看 facebook 的 api: https://developers.facebook.com/docs/graph-api/making-multiple-requests
        30
    jingniao   221 天前 via Android
    一直是逗号分隔
        31
    Raymon111111   221 天前
    就是 list 啊
        32
    Leammin   221 天前 via Android
    @GuryYu 老哥你解决了我困扰已久的问题!
        33
    Leammin   221 天前 via Android
    @GuryYu 不过 delete 要怎么办
        34
    freakxx   221 天前
    python -- django

    GET http://server/books?id=1001,1002

    id = "1001, 1002"
    id = id.split(",")

    >>> ['1001', ' 1002']
        35
    skinny   221 天前
    @Leammin 你都用了 RESTFUL,难道还用 POST 删除? DELETE 请求被你吃了?
        36
    corningsun   221 天前
    Swagger UI 自动生成的是 第一种
    第二种 URL 长度明显更短

    后端 Java Spring 的话,第一种和第二种都是支持的。
        37
    oongxx   221 天前
    如果你的 API 用了 OData 规范,那就用 http://host/service/Products?$filter=Name in ('Milk', 'Cheese')

    https://stackoverflow.com/questions/7745231/odata-where-id-in-list-query
        38
    wizardoz   221 天前
    我想知道为啥会出现要用两个 id 来取两本书这种需求?
    id 自然不是随便来的,比如 mike 收藏的两本书,那就用
    http://server/books?favor_by=mike
    来过滤啊。
        39
    JamesC   221 天前
    个人的做法是 /api/resources/(1,3,5,7)
    其实重点在于做好 API 接收解析,id 之间分隔的规范.
    直接获取是不现实的.如何编写符合 Restful 原则的规范才重要.
    又或者 /api/resources?ids=1,3,5,7 也是可以的,路径要清晰,意义明显.
    ps:既然选择了 Restful 的设计思路就尽量符合规范.
        40
    Leammin   220 天前 via Android
    @skinny ?我说的就是 delete 啊,我意思是批量删除要怎么操作。
        41
    yc8332   209 天前
    只能传字符串啊。。。至于形式,看你喜欢啊
    关于   ·   FAQ   ·   API   ·   我们的愿景   ·   广告投放   ·   感谢   ·   实用小工具   ·   3484 人在线   最高记录 5043   ·  
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.3 · 20ms · UTC 10:20 · PVG 18:20 · LAX 03:20 · JFK 06:20
    ♥ Do have faith in what you're doing.
    沪ICP备16043287号-1