很多时候,你可能不希望在一次请求中检索所有数据,你可以使用 limit 和 offset 参数来指定你想要检索的数据数量,以及在开始时要跳过的数据数量,这样订户端就可以实现调页查看数据。
limit 和 offset 参数的使用方式类似于 SQL 的 limit 参数。Offset 是在开始时要跳过的数据数量,limit 是要回传的数据数量。
默认回传数据量是 1000 笔,如果希望回传包含超过 1000 笔数据,则需要提供 limit 参数。
格式如下:
limit=< limit >&offset=< offset >
offset 参数表示在回传之前应跳过的数据数量,用于浏览已检索页面。 limit 参数是每次调用应回传的最大数据数。
例如,下面的调用将跳过前 5 笔数据,并回传第 6 到 13 笔,总共 8 笔数据。
curl --get -d "limit=8" \ -d "offset=5" \ -H "Authorization:Basic YOUR_API_KEY_GOES_HERE" \ -d api \ https://www.ragic.com/demo/sales/1