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

费率限制

应用程序接口的运行速率限制为每 10 分钟 1200 次请求。 这意味着在任何 10 分钟内，每秒最多可发送 2 个请求。 请注意，这个限额是我们所有端点共享的，而不是计入单个端点。

如果超过此限制，您将收到429 太多请求回复。

当前的速率限制状态可在RateLimit标头中查看。

例如

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

参见 IETF 草案了解更多详情。

如果您在达到此限制时遇到问题，请在请求之间引入一段延迟时间，以便再次低于限制。

过滤器/路径参数

使用路径参数进行过滤时，每次调用最多只能有50 个参数（即用户 ID）。

分页

每页最多可显示 50 个结果。 使用页面和每页查询参数获取更多结果。

 

例如

/users?page=3&per_page=30

如何从有分页限制的应用程序接口获取所有数据？
注意：本例使用的是 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. 定期（如每周）执行一次重新同步，再次获取所有数据并更新副本。