國博史上首次收藏代碼！代碼的 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同步是我目前記筆記的方式。不知道適不適合別人，反正目前來看這種方式我最喜歡。

簡單給你們看一下個人筆記分類目錄吧（挺雜的，最近會優化目錄）：

（這周應該會把本身的所得所獲分享出來）。