• 请不要在回答技术问题时复制粘贴 AI 生成的内容
JasonLaw
V2EX  ›  程序员

关于 RESTful API 的疑问

  •  
  •   JasonLaw · Mar 22, 2022 · 3498 views
    This topic created in 1706 days ago, the information mentioned may be changed or developed.

    我正在设计一个“获取系统是否维护中”的 API ,现在的设计为:

    GET /config/SYSTEM_MAINTAINING/value
    

    SYSTEM_MAINTAINING 是 config key 的名称,但是前端却觉得 URL 上不应该存在这样风格的命名,应该为 systemMaintaining 才对。想看看大家的意见。

    Supplement 1  ·  Mar 22, 2022
    不讨论了🤐 没有答案的
    CEBBCAT
    CEBBCAT
    Mar 22, 2022 via iPhone
    1
    多加两个 key ,把他搞到晕头转向,这时候就可以说,内部变量太多,不适合逐一映射,还是原样传递符合情况
    Vitta
    Vitta
    Mar 22, 2022
    2
    这也不好看啊,怎么好看怎么来吧, 你们中和一下,用 system_maintaining 吧
    HYisen
    HYisen
    Mar 22, 2022 via Android
    3
    前端传统 case insensitive ,应该是 system-maintaining 才对。
    pennai
    pennai
    Mar 22, 2022
    4
    restful 风格 url 应该是全小写+下划线吧,哪有用 camel case 的
    hakr
    hakr
    Mar 22, 2022
    5
    占位符而已 无所谓吧 只要在那个位置就行
    shakaraka
    shakaraka
    Mar 22, 2022
    6
    url 统一用小写+下划线,能解决 99%的问题
    adeng
    adeng
    Mar 22, 2022
    7
    有两年了记不清了什么情况,我碰到过 url 用驼峰命名的问题,不应该区分大小写
    Rache1
    Rache1
    Mar 22, 2022
    8
    额,为啥不直接这样呢。

    GET /config?key=system_maintaining

    key 或者 field
    iseki
    iseki
    Mar 22, 2022
    9
    URL 里大小写敏感太不友好了,不妨 system-maintaining 或者 system_maintaining 更好
    thinkershare
    thinkershare
    Mar 22, 2022
    10
    我们的设计原则是: 全部小写, 然后使用-分隔, 不需要 value 参数, GET /config/system-maintaining, 很多国际互联网企业的 API 也是这个规范, 另外并不是所有的 API 都适合 RESTful Style, 使用动词风格也没啥大的缺陷
    jiangxiaoshui
    jiangxiaoshui
    Mar 22, 2022
    11
    system-maintaining
    dubstep
    dubstep
    Mar 22, 2022
    12
    elboble
    elboble
    Mar 22, 2022
    13
    url 大小写不区分,所以驼峰没用,其他自便
    wu67
    wu67
    Mar 22, 2022
    14
    /system/maintain/getStatus
    icy37785
    icy37785
    Mar 22, 2022 via iPhone❤️2
    15
    我点开帖子看楼主的附言“不讨论了,没有答案的”以为底下吵起来了
    我寻思小写加下划线不就完了,有啥好吵的
    然后看到底下非常和谐都跟我想法一样,不禁陷入了沉思
    楼主说的没有答案是指的啥…
    JasonLaw
    JasonLaw
    OP
    Mar 22, 2022
    16
    @icy37785 #15 就是其实都可以,没有哪个答案是“正确”的,我不想花费太多时间在这上面。
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Privacy   ·   Solana   ·   991 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 44ms · UTC 23:22 · PVG 07:22 · LAX 15:22 · JFK 18:22
    ♥ Do have faith in what you're doing.