专栏名称: 架构师之路
架构师之路,坚持撰写接地气的架构文章
目录
相关文章推荐
美团技术团队  ·  让迪拜,见证中国配送新速度 ·  2 天前  
架构师之路  ·  手贱删了DB,如何快速恢复?(第24讲) ·  4 天前  
架构师之路  ·  超经典,网页判重核心技术!(第25讲) ·  3 天前  
架构师之路  ·  加速MySQL主从同步,核心架构设计思路!( ... ·  6 天前  
架构师之路  ·  又一篇10W+,但都是骂我的... ·  1 周前  
51好读  ›  专栏  ›  架构师之路

80后聊架构:API端点,REST,URI... 这些概念与规范都不重要了吗? | 架构师之路

架构师之路  · 公众号  · 架构  · 2024-11-05 17:03

主要观点总结

文章主要围绕“架构设计中100个知识点”的第5集内容展开,讲述了作者发布关于API端点、REST实践和URI规范的视频后,对于观众评论的反思。作者通过自我反思、内容检查和态度分析,对于观众的批评进行了解读,并提供了相关补充阅读材料。

关键观点总结

关键观点1: 文章概述了作者发布视频后的反馈情况。

作者对于观众的评论感到惊讶,对自我情绪、内容和态度进行了反思。

关键观点2: 作者自我反思的三方面内容。

包括情绪、内容和态度,作者认为自己没有问题,但对于观众的反馈感到困惑。

关键观点3: 文章提到的观众反馈的主要内容。

观众反馈主要集中在三个方面:对API端点、REST和URI规范的不了解及其影响,对作者态度的质疑,以及关于技术与职场的一些看法。

关键观点4: 作者提供的补充阅读材料。

包括API端点、REST实践和URI规范的资源链接,以及对于URI设计的一些简要规范的探讨。

关键观点5: 文章最后作者的总结和启示。

作者从反馈中得到的启示是:短视频可能不适合讲技术,技术人的职业发展不仅取决于专业知识,还取决于认知水平。作者表示会更多地在公号图文中分享干货内容,并尝试输出一些职场心态和认知的内容。


正文

《架构师之路:架构设计中的100个知识点
5.API端点,REST实践,URI规范...

昨天晚上,刚发布完“架构设计中100个知识点的第5集:API端点,REST实践,URI规范...:
没想到,短短2分钟的视频,不到半天时间,几千的浏览,居然200+评论喷我...

【1】自我反思:我的情绪出问题了吗?

我不屑一顾了吗?似乎没有。
我嘲讽候选人了吗?似乎没有。
我自我炫耀了吗?没有也没有。

如果硬要说情绪,我想更多的是惊讶

惊讶什么?

惊讶一:
我以为做Web开发,看过一些源码注释,或者查过一些资料,或多或少应该知道API endpoint,人不知道,确实有些出乎我的意料。
画外音:当然,不排除有些童鞋从来没查阅过英文资料。

事后我还询问了自己团队的FE和Java的童鞋,他们也都表示,这个概念很基础。

惊讶二:
候选人知道REST,但不知道表现层和状态转移。
难道REST不是 Representational State Transfer (表现层状态转移)的缩写吗

惊讶三:
候选人知道URI,但不知道URI设计的一些基础规范。例如:斜杠的问题,短横线与下划线的问题,大小写的问题。

咱们后端,不需要向前端提供接口吗?
接口是:http://api.com/shapes/
还是:http://api.com/shapes

是:http://api.com/blogs/my_first_post
还是:http://api.com/blogs/my-first-post

是:http://api.com/My-Folder/My-Doc 
还是:http://api.com/my-folder/my-doc 
真的没有关系吗?

惊讶四:
候选人对我的几个反问:
“不知道API端点,影响什么?”
“不知道URI规范,影响什么?”
“我全都使用POST,影响什么?”
...
他理直气壮地认为自己是对的,更让我倍感惊讶。
画外音:评论留言里对“影响什么”的支持,也让我惊讶。

【2】自我反思:内容出问了吗?
URI的结尾加上反斜杠(/),可能导致误解,导致性能问题,没毛病呀。

我会在图文里,把“API端点,REST,URI”这些短视频里埋的坑填上,也没毛病呀。

【3】自我反思:态度出问了吗?
我觉得短视频里自己表达的态度还是挺清晰的:
1. 掌握这些基础规范有必要
2. 我们自己尊重技术,别人才可能尊重我们
3. 环境对我们很不友好,我们要抱团取暖,一起加油

似乎,我的态度也很友善呀。

情绪,内容,态度似乎都没啥问题,那为啥大家在评论区出奇团结的喷我呢?
说得最多的是这种:
孔乙己,炫耀茴字有几种写法...
只会背八股文,搞概念,估计没写过代码...
...

其次是这种:
7年Java,日交易4个亿,也不知道这些,影响什么?
开发20年,自研web框架,20万tps,也不知道这些,影响什么?
...

然后是这种:
面试造火箭,上班打螺丝...
懂这些,就不用996了吗,就不会被裁了吗...
...

最后还有一类:
只知道满嘴炫英文...
都有AI了,为啥还要知道这些...
有必要遵循国外的标准和规范吗...
...
我简直哭笑不得。

想了半天也不理解,到底触动了大伙哪根神经,自己到底错在了哪里?

好了,不展开了,回归技术,挖的坑要填。API端点,REST实践,URI规范相关补充阅读材料如下

【1】API endpoint
怕有些同学访问不了,找了一个相对权威且不用搭TZ的链接:
https://www.ibm.com/topics/api-endpoint
不复杂,较为基础,也不是一个新概念。

知道的,可以直接略过。
不知道的,不了解也没关系,不会影响搬砖。
花5分钟了解下,可能不能涨薪。
决定权,在大家自己。

【2】REST实践
REST,核心要素,面向资源的架构的概念,一张图就能说清楚。REST之父提出的HATEOAS架构,可参考:
REST之父,搞了一个HATEOAS架构?

【3】URI规范
URI规范,RFC3986,链接给到大家:
https://www.rfc-editor.org/rfc/rfc3986
比较枯燥,估计大家读不进去。

短视频中提到的3个具体问题:
极客匠心同学说的是对的:
1. URI不带反斜线;
2. 建议全小写;
3. 建议短横线;
画外音:当然,大家可以不遵守,毕竟,又影响什么了呢?

另外,我之前写过一篇:
如何设计,容易挨揍的URI?
用戏谑的口吻,聊URI设计中的一些简要规范,亦可参考。

==全文完==

虽然喷我的人很多,但从200+条评论中,我还是有一些收获和启示的:

有童鞋说,大家刷短视频是要消磨时间,发泄情绪,满足的是大家的情绪价值,不适合讲技术。

也有童鞋说,看了评论区的大量留言,更容易理解,为什么程序员会有35+危机。决定一个技术人职业发展的,从来不是专业知识,而是认知水平。

一方面:干货内容我会更多放在公号图文,短视频氛围不太友好
另一方面:除了专业内容,也尝试输出一些职场心态,职场认知的内容,说不定这些更能帮助到大家。

100个架构知识点,还是会继续讲下去。感谢大家的支持,希望大家能有收获。

寒冬,咱们抱团取暖,一起加油!
共勉!