国博史上首次收藏代码！代码的 URL 设计还没遵循RESTful API 风格？

阿里抗疫代码入藏国博

中国国家博物馆又要上新了。最新入藏中国国家博物馆的藏品是阿里抗疫的 30 件物资，包括抗疫期阿里程序员们写的代码。这也是国博历史上首次收藏代码。

真给程序员长脸！

中国国家博物馆向阿里巴巴集团、蚂蚁集团，阿里巴巴公益基金会和马云公益基金会颁发“援助抗击新冠疫情实物捐赠证书”。

在这份捐赠清单中，让人眼前一亮是三个“第一行代码”：支付宝团队研发的健康码系统第一行代码；阿里云研发的全国健康码引擎第一行代码；阿里巴巴达摩院研发的新冠肺炎 CT 影像 AI 辅助诊断产品第一行代码。

这是中国国家博物馆历史上第一次收藏代码。这三行代码下面，是 42 名写代码的阿里程序员的签名，阿里云的程序员们还附上了我的头像。

题外话（非杠）

咱们来仔细看一下这段代码哈，非杠精。

这段Controller代码的 URL 设计貌似和常规的 RESTful API 约定不太同样。

1. RESTful API 风格规定不用大写字母，建议用中杠 - 不用下杠 _ 好比邀请码写成 invitation-code 而不是 invitation_code

2. RESTful API 风格规定网址中不能有动词，只能有名词，API 中的名词也应该使用复数。由于 REST 中的资源每每和数据库中的表对应，而数据库中的表都是同种记录的"集合"（collection）。若是 API 调用并不涉及资源（如计算，翻译等操做）的话，能够用动词。 好比：GET /calculate?param1=11&param2=33

其实也不用太纠结，我这里只是随口一说。只要团队达成一致就好，咱们程序员都是很好说话很友善的一群人嘛！。

这段代码后面可能也被重构成了 RESTful 风格。怎么说呢? 若有可能，就尽可能准守 RESTful API 风格吧。有一些项目没有准守 RESTful API 风格多是项目历史遗留问题好比修改为本比较大或者说项目成员达成了共识不遵照 RESTful API 风格。

不过，仍是建议你们尽可能能遵照比较好的实践

闲聊

我平时是一个特别喜欢记录的人，我遇到的好文章，看过的好书，学习过的好专栏，我都会记录下来，记录本身的所得所获。

Typora+Github同步是我目前记笔记的方式。不知道适不适合别人，反正目前来看这种方式我最喜欢。

简单给你们看一下个人笔记分类目录吧（挺杂的，最近会优化目录）：

（这周应该会把本身的所得所获分享出来）。