分页

使用 limit 和 offset 来控制分页数据：

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

默认 limit 为 20, offset 为 0，我们也可以手动指定 limit 和 offset 来控制。例如，每页展示 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 升序排序

请求示例 {% tabs getRecordUseCurl=”curl”, getRecordUsePython=”python” %}

{% content “getRecordUseCurl” %}

  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

{% content “getRecordUsePython” %}

  1. import json
  2. import urllib
  4. import requests
  7. table_name = ''
  8. BASE_API = r'https://{{服务器域名}}/hserve/v2.2/table/%s/record/' % table_name
  10. TOKEN = ''
  11. HEADERS = {
  12.   'Authorization': 'Hydrogen-r1 %s' % TOKEN
  13. }
  15. where_ = {
  16.   'price': {'$gt': 100},
  17. }
  19. query_ = urllib.urlencode({
  20.   'where': json.dumps(where_),
  21.   'order_by': '-created_at',
  22.   'limit': 10,
  23.   'offset': 0,
  24. })
  26. API = '?'.join((BASE_API, query_))
  28. resp_ = requests.get(API, headers=HEADERS)
  29. print resp_.content

{% endtabs %}