Heroku API 設計指南

• 總是用 TLS
• 使用 ETag
• 提供 created_at 與 updated_at 時間戳記
• 時間使用 ISO8601 UTC 格式，2012-01-01T12:00:00Z
• 使用 Leaky Bucket 來限制 Request Rate Limit，這個水桶理論 滿有趣的
• Response 壓縮 JSON ，去掉空白，換行符號
• 產生 JSON 文件，並提供呼叫範例 PRMD
• 描述 Resource 的穩定性

Bucket 原理

參考：https://zhuanlan.zhihu.com/p/20872901

1. 所有的流量在放行之前需要獲取一定量的token；
2. 所有的token 存放在一個bucket（桶）當中，每1/r 秒，都會往這個bucket 當中加入一個token；
3. bucket 有最大容量（capacity or limit），在bucket 中的token 數量等於最大容量，而且沒有token 消耗時，新的額外的token 會被拋棄。