关于 RESTful API 的疑问

2022-03-22 12:34:30 +08:00
 JasonLaw

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

GET /config/SYSTEM_MAINTAINING/value

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

1962 次点击
所在节点    程序员
16 条回复
CEBBCAT
2022-03-22 12:44:08 +08:00
多加两个 key ,把他搞到晕头转向,这时候就可以说,内部变量太多,不适合逐一映射,还是原样传递符合情况
Vitta
2022-03-22 12:50:24 +08:00
这也不好看啊,怎么好看怎么来吧, 你们中和一下,用 system_maintaining 吧
HYisen
2022-03-22 12:52:39 +08:00
前端传统 case insensitive ,应该是 system-maintaining 才对。
pennai
2022-03-22 12:53:48 +08:00
restful 风格 url 应该是全小写+下划线吧,哪有用 camel case 的
hakr
2022-03-22 13:10:31 +08:00
占位符而已 无所谓吧 只要在那个位置就行
wunonglin
2022-03-22 13:15:02 +08:00
url 统一用小写+下划线,能解决 99%的问题
adeng
2022-03-22 13:20:25 +08:00
有两年了记不清了什么情况,我碰到过 url 用驼峰命名的问题,不应该区分大小写
Rache1
2022-03-22 13:37:38 +08:00
额,为啥不直接这样呢。

GET /config?key=system_maintaining

key 或者 field
iseki
2022-03-22 13:42:36 +08:00
URL 里大小写敏感太不友好了,不妨 system-maintaining 或者 system_maintaining 更好
thinkershare
2022-03-22 13:43:25 +08:00
我们的设计原则是: 全部小写, 然后使用-分隔, 不需要 value 参数, GET /config/system-maintaining, 很多国际互联网企业的 API 也是这个规范, 另外并不是所有的 API 都适合 RESTful Style, 使用动词风格也没啥大的缺陷
jiangxiaoshui
2022-03-22 14:54:48 +08:00
system-maintaining
dubstep
2022-03-22 14:57:12 +08:00
elboble
2022-03-22 15:03:03 +08:00
url 大小写不区分,所以驼峰没用,其他自便
wu67
2022-03-22 15:13:42 +08:00
/system/maintain/getStatus
icy37785
2022-03-22 15:14:14 +08:00
我点开帖子看楼主的附言“不讨论了,没有答案的”以为底下吵起来了
我寻思小写加下划线不就完了,有啥好吵的
然后看到底下非常和谐都跟我想法一样,不禁陷入了沉思
楼主说的没有答案是指的啥…
JasonLaw
2022-03-22 15:48:54 +08:00
@icy37785 #15 就是其实都可以,没有哪个答案是“正确”的,我不想花费太多时间在这上面。

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/842077

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX