Restful API 里,应该怎么处理最后的 / - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
lhbc
V2EX    API

Restful API 里,应该怎么处理最后的 /

  •  
  •   lhbc 2016-02-22 12:03:48 +08:00 via Android 3698 次点击
    这是一个创建于 3526 天前的主题,其中的信息可能已经有所发展或是发生改变。

    按规范,比如请求用户列表,应该是
    /api/users
    那对于 /api/users/ 这种请求应该直接 404 还是等同 /api/users 处理?

    20 条回复    2016-02-23 10:29:56 +08:00
    v1024
        1
    v1024  
       2016-02-22 12:32:22 +08:00
    标准的话,应该不处理结尾的 / ,因为 / 代表目录,隐含意思是 /index.htm 。
    Jafee
        2
    Jafee  
       2016-02-22 12:34:28 +08:00
    dacapoday
        3
    dacapoday  
       2016-02-22 12:34:52 +08:00
    直接返回一套字符串 显示 接口的说明,格式,使用方法?
    或者该 API 的运行状态?
    dacapoday
        4
    dacapoday  
       2016-02-22 12:37:15 +08:00
    错了错了,我以为是根目录,无视上条
    learnshare
        5
    learnshare  
       2016-02-22 12:59:39 +08:00
    #1 的观点是对的,加了 / 代表这个目录,默认是 /index.html
    timonwong
        6
    timonwong  
       2016-02-22 13:16:45 +08:00
    对于 1 楼的观点,也有另外一种解释
    因为请求列表是一个 LIST 行为,对于 LIST 行为,应该按照目录处理,所以就应该是
    GET /api/users/
    lhbc
        7
    lhbc  
    OP
       2016-02-22 13:48:41 +08:00
    @v1024
    @learnshare
    @timonwong
    GET /api/users/ 这个操作应该没问题
    不过对 /api/users/ 进行 POST(添加用户) 好像有点怪怪的

    Restful 里好像没定义目录的概念,所有想弄清楚规范里是建议怎么处理的
    搜索 restful directory, restful "last splash" 都没找到相关内容


    @Jafee
    这篇文章是对应浏览器和蜘蛛
    Restful 应该不太一样
    dorentus
        8
    dorentus  
       2016-02-22 14:02:49 +08:00
    实在不知道的话就参考别人的实现么,例如 github 的:
    https://api.github.com/user 是可用的
    https://api.github.com/user/ 则返回 404
    lhbc
        9
    lhbc  
    OP
       2016-02-22 14:07:27 +08:00
    @dorentus 忘记了去参考一些大站的实现
    thanks all.
    mcfog
        10
    mcfog  
       2016-02-22 14:53:25 +08:00
    @lhbc 因为 splash 是飞溅, slash 才是斜杠

    另外,一般说 trailing slash
    learnshare
        11
    learnshare  
       2016-02-22 15:32:28 +08:00
    @lhbc RESTful 也是基于 HTTP ,参考 HTTP 协议的实现就好了
    carlding
        12
    carlding  
       2016-02-22 18:00:25 +08:00
    在 chrome 输入 www.baidu.com ,等进入网页后你把 url 复制粘贴到文本会发现自动多加了一个'/',所以还是等同处理吧。
    这个'/'有无大部分人应该都会忽略吧。
    毕竟不能将'/'后面认为是一个空字符串吧。
    qq529633582
        13
    qq529633582  
       2016-02-22 18:49:28 +08:00 via iPhone
    @carlding 这个只有根目录才会的
    aprikyblue
        14
    aprikyblue  
       2016-02-22 19:08:04 +08:00
    @carlding
    只有根目录+1 ,
    根目录是 /,为空就不太科学了吧。。

    以前看某些文章貌似说一些 http server 会把 http[s]://host 给 301 到 http[s]://host/ (当然前提是 client 发出了这种请求),没验证过


    另外对 LZ 问题,我赞同 6L
    jybox
        15
    jybox  
       2016-02-22 19:50:02 +08:00
    我想提一种情况,比如有两个 API : DELETE /users 和 DELETE /users/:name ,分别是删除所有用户和删除指定用户。如果在调用后者时忘记加 name ,就变成了 DELETE /users/,我觉得最好还是不要当作前者,而是直接报错好一些。
    owlsec
        16
    owlsec  
       2016-02-22 20:02:24 +08:00
    @jybox 心疼 leancloud
    lhbc
        17
    lhbc  
    OP
       2016-02-22 21:10:31 +08:00
    @jybox
    @owlsec
    这个……真有真实案例?
    julyclyde
        18
    julyclyde  
       2016-02-22 22:28:45 +08:00 via iPad
    @aprikyblue 发不出这种请求。你看看 http 请求行的格式
    aprikyblue
        19
    aprikyblue  
       2016-02-22 23:02:17 +08:00
    @julyclyde 我也想到了 http 请求的格式,所以才说“为空就不太科学了”
    刚才去试了试,百度神马也没返回,必应返回了 400 Bad Request
    是我道听途说了
    dalang
        20
    dalang  
       2016-02-23 10:29:56 +08:00
    我自己写得 rest api , /api/users/ 这种请求是直接 404 处理。
    关于     帮助文档     自助推广系统     博客     API     FAQ     Solana     1231 人在线   最高记录 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 24ms UTC 17:36 PVG 01:36 LAX 10:36 JFK 13:36
    Do have faith in what you're doing.
    ubao msn snddm index pchome yahoo rakuten mypaper meadowduck bidyahoo youbao zxmzxm asda bnvcg cvbfg dfscv mmhjk xxddc yybgb zznbn ccubao uaitu acv GXCV ET GDG YH FG BCVB FJFH CBRE CBC GDG ET54 WRWR RWER WREW WRWER RWER SDG EW SF DSFSF fbbs ubao fhd dfg ewr dg df ewwr ewwr et ruyut utut dfg fgd gdfgt etg dfgt dfgd ert4 gd fgg wr 235 wer3 we vsdf sdf gdf ert xcv sdf rwer hfd dfg cvb rwf afb dfh jgh bmn lgh rty gfds cxv xcv xcs vdas fdf fgd cv sdf tert sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf shasha9178 shasha9178 shasha9178 shasha9178 shasha9178 liflif2 liflif2 liflif2 liflif2 liflif2 liblib3 liblib3 liblib3 liblib3 liblib3 zhazha444 zhazha444 zhazha444 zhazha444 zhazha444 dende5 dende denden denden2 denden21 fenfen9 fenf619 fen619 fenfe9 fe619 sdf sdf sdf sdf sdf zhazh90 zhazh0 zhaa50 zha90 zh590 zho zhoz zhozh zhozho zhozho2 lislis lls95 lili95 lils5 liss9 sdf0ty987 sdft876 sdft9876 sdf09876 sd0t9876 sdf0ty98 sdf0976 sdf0ty986 sdf0ty96 sdf0t76 sdf0876 df0ty98 sf0t876 sd0ty76 sdy76 sdf76 sdf0t76 sdf0ty9 sdf0ty98 sdf0ty987 sdf0ty98 sdf6676 sdf876 sd876 sd876 sdf6 sdf6 sdf9876 sdf0t sdf06 sdf0ty9776 sdf0ty9776 sdf0ty76 sdf8876 sdf0t sd6 sdf06 s688876 sd688 sdf86