80后聊架构:API端点,REST,URI... 这些概念与规范都不重要了吗? | 架构师之路
科技
2024-11-05 17:05
北京
昨天晚上,刚发布完“架构设计中100个知识点”的第5集:API端点,REST实践,URI规范...:没想到,短短2分钟的视频,不到半天时间,几千的浏览,居然200+评论喷我...我以为做Web开发,看过一些源码注释,或者查过一些资料,或多或少应该知道API endpoint,候选人不知道,确实有些出乎我的意料。画外音:当然,不排除有些童鞋从来没查阅过英文资料。
事后我还询问了自己团队的FE和Java的童鞋,他们也都表示,这个概念很基础。
难道REST不是 Representational State Transfer (表现层状态转移)的缩写吗?候选人知道URI,但不知道URI设计的一些基础规范。例如:斜杠的问题,短横线与下划线的问题,大小写的问题。接口是: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 画外音:评论留言里对“影响什么”的支持,也让我惊讶。URI的结尾加上反斜杠(/),可能导致误解,导致性能问题,没毛病呀。
我会在图文里,把“API端点,REST,URI”这些短视频里埋的坑填上,也没毛病呀。3. 环境对我们很不友好,我们要抱团取暖,一起加油;情绪,内容,态度似乎都没啥问题,那为啥大家在评论区出奇团结的喷我呢?7年Java,日交易4个亿,也不知道这些,影响什么?
开发20年,自研web框架,20万tps,也不知道这些,影响什么?想了半天也不理解,到底触动了大伙哪根神经,自己到底错在了哪里?好了,不展开了,回归技术,挖的坑要填。API端点,REST实践,URI规范相关补充阅读材料如下:怕有些同学访问不了,找了一个相对权威且不用搭TZ的链接:https://www.ibm.com/topics/api-endpointREST,核心要素,面向资源的架构的概念,一张图就能说清楚。REST之父提出的HATEOAS架构,可参考:https://www.rfc-editor.org/rfc/rfc3986画外音:当然,大家可以不遵守,毕竟,又影响什么了呢?
用戏谑的口吻,聊URI设计中的一些简要规范,亦可参考。虽然喷我的人很多,但从200+条评论中,我还是有一些收获和启示的:有童鞋说,大家刷短视频是要消磨时间,发泄情绪,满足的是大家的情绪价值,短视频不适合讲技术。也有童鞋说,看了评论区的大量留言,更容易理解,为什么程序员会有35+危机。决定一个技术人职业发展的,从来不是专业知识,而是认知水平。
一方面:干货内容我会更多放在公号图文,短视频氛围不太友好。另一方面:除了专业内容,也尝试输出一些职场心态,职场认知的内容,说不定这些更能帮助到大家。100个架构知识点,还是会继续讲下去。感谢大家的支持,希望大家能有收获。