Thinking more...

來源：Best practices for REST API design

下面是看完以後，我的整理、摘要以及一點自己的想法：

• 盡可能使用 JSON (application/json)，除非有特殊需求，才來考慮使用其他格式，例如 form (上傳檔案) 或是 xml
• 使用名詞，而非動詞：這樣才能搭配 HTTP verbs 的 POST/DELETE/GET/PUT，POST 放新資料到伺服器上，DELETE 移除資料，GET 取得資料，PUT 是更新資料
• 時使用複數，表示取得一堆資料。
• 階層物件可以使用巢狀資源，例如 /articles/article_id/comments/ 。P.S. 碰到這種情況其實也可以考慮使用 GraphQL
• 漂亮的處理錯誤並回傳錯誤代碼，盡可能利用 HTTP 狀態碼而不要另外建立新的錯誤代碼。伺服器端在回傳錯誤時，可以帶上錯誤訊息，讓客戶端便於判斷、處理。
• 允許篩選、排序跟分頁。篩選跟分頁可以避免一次拿過多資料，導致伺服器傳輸過多資料，也可以提升速度，拿的少，自然就快，對吧~
• 安全性，SSL/TLS 是必要的，再來就是處理好使用者能存取的資源權限，這部份是實作 API 時必須要考慮到的。
• 要用 cache，實作時要想，這資料會很常變動嗎？會很常被索取嗎？不常變動又很常被索取，就放到 cache 吧。
• 幫 API 編上版號，這可以避免影響到舊有的 API，一方面也可以單純化，不用考慮到過多相容性的問題。例如：/v1, /v2