Motimate：公共 API 的使用有任何限制嗎？

費率限制

API 的操作速率限制為每 10 分鐘 1200 次請求。 這表示在任何 10 分鐘內，您每秒最多只能傳送 2 個要求。 請注意，此限額是由我們所有的端點共用，而非計入個別端點。

如果超過此限制，您將收到429 Too Many Requests回應。

目前的速率限制狀態可在RateLimit標頭中找到。

範例：

RateLimit: limit=1200, remaining=956, reset=543

請參閱 IETF 草案瞭解更多詳細資訊。

如果您遇到觸及此限制的問題，請在請求之間引入一段延遲時間，以便再次低於限制。

過濾器 / 路徑參數

當使用路徑參數過濾時，每次呼叫有50 個參數(即使用者 ID) 的限制。

分頁

每頁最大結果為 50 個。 使用page和per_page查詢參數來取得額外的結果。

 

範例：

/users?page=3&per_page=30

如何從有分頁限制的 API 取得所有資料？
注意：本範例使用 GET /groups，但您可以使用其他端點重複此步驟。

1.  

   1. 擷取所有資料：

      for i in {1..NUMBER_OF_PAGES}; do
      
          curl -X GET "https://motimateapp.com/public_api/groups?page=$i"
      
          done

   2. 將資料儲存在您的機器上。
       

   3. 只擷取上次擷取 (例如一天前) 之後更新或建立的資源，並將其合併到您已有的資料中：

      
        curl -X GET "https://motimateapp.com/public_api/groups?filter[created_at_gt]=<ONE_DAY_AGO>"
      
        curl -X GET "https://motimateapp.com/public_api/groups?filter[updated_at_gt]=<ONE_DAY_AGO>"
      
        

   4. 每當執行 DELETE 請求時，請將資源從副本中移除。
       
   5. 定期 (例如每週) 執行重新同步，再次取得所有資料並更新您的副本。