分页

使用 limitoffset 来控制分页数据:

  • limit 指定该请求返回的结果个数
  • offset 偏移量,指定该请求返回的结果的起始位置

默认 limit 为 20, offset 为 0,我们也可以手动指定 limitoffset 来控制。例如,每页展示 100 条数据,需要获取第五页的数据,将 limit 设置为 100、offset 设置为 400 即可。limit 最大可设置为 1000。

请求示例

获取从第 5 条起,最多的 10 条的数据表记录

  1. curl -X GET \
  2. -H "X-Hydrogen-Client-ID: [[client_id]]" \
  3. -H "Authorization: Hydrogen-r1 {{AccessToken}}" \
  4. -H "Content-Type: application/json" \
  5. https://{{服务器域名}}/hserve/v2.2/table/952728/record/?limit=10&offset=5

排序

查询接口默认按创建时间倒序的顺序来返回数据列表,你也可以通过设置 order_by 参数来实现。

order_by 的值必须为 table 表中的字段,可支持多重排序,字段之间用 , 隔开,以下是 order_by 的一些例子:

  • /hserve/v2.2/table/:table_name/record/?order_by=created_at: 按照 created_at 升序排序
  • /hserve/v2.2/table/:table_name/record/?order_by=-created_at: 按照 created_at 倒序排序
  • /hserve/v2.2/table/:table_name/record/?order_by=-created_at,id: 多重排序,先按照 created_at 降序,再按照 id 升序排序

请求示例

  1. curl -X GET \
  2. -H "X-Hydrogen-Client-ID: [[client_id]]" \
  3. -H "Authorization: Hydrogen-r1 {{AccessToken}}" \
  4. -H "Content-Type: application/json" \
  5. https://{{服务器域名}}/hserve/v2.2/table/952728/record/?order_by=-created_at
  1. import json
  2. import urllib
  3. import requests
  4. table_name = ''
  5. BASE_API = r'https://{{服务器域名}}/hserve/v2.2/table/%s/record/' % table_name
  6. TOKEN = ''
  7. HEADERS = {
  8. 'Authorization': 'Hydrogen-r1 %s' % TOKEN
  9. }
  10. where_ = {
  11. 'price': {'$gt': 100},
  12. }
  13. query_ = urllib.urlencode({
  14. 'where': json.dumps(where_),
  15. 'order_by': '-created_at',
  16. 'limit': 10,
  17. 'offset': 0,
  18. })
  19. API = '?'.join((BASE_API, query_))
  20. resp_ = requests.get(API, headers=HEADERS)
  21. print resp_.content