Greenhouse Harvest API用户权限接口分页异常问题求助

问题根因 #

你遇到的分页异常是因为用户作业权限接口的分页机制和其他接口不一样——它用的是since_id游标分页，不是常规的page页码分页。你用page=1请求时，接口返回的next链接里虽然带了since_id，但page参数会被接口忽略，导致看起来还是指向当前页。

修复步骤 #

• 首次请求不要传page参数：
  直接调用接口，只传per_page（可选，默认100）：

  response = requests.get('https://harvest.greenhouse.io/v1/users/1372428/permissions/jobs?per_page=100', auth=('api_key',''))
  

• 用响应头里的next链接翻页：
  从返回的link头里拿到next链接，直接发起下一次请求就行。比如你之前得到的链接：

  <https://harvest.greenhouse.io/v1/users/1372428/permissions/jobs?per_page=100&since_id=133383843>; rel="next"
  

  这个链接里的since_id是接口自动生成的下一页起始标识，不用你手动修改，一直请求到link头里没有next，就说明数据拿完了。
• 手动控制游标（可选）：
  要是你想自己控制分页逻辑，可以从当前页返回的最后一条权限数据里取id，把它作为下一次请求的since_id参数：

  # 假设当前页数据存在permissions列表中
  last_permission_id = permissions[-1]['id']
  next_response = requests.get(
      f'https://harvest.greenhouse.io/v1/users/1372428/permissions/jobs?per_page=100&since_id={last_permission_id}',
      auth=('api_key','')
  )
  

官方文档对应说明（中文翻译） #

用户权限接口的分页规则明确：

该接口采用基于since_id的游标分页，而非页码分页。当请求包含since_id时，接口会返回ID大于该值的权限记录。响应头的link字段会提供next关系的链接，其中包含获取下一页所需的since_id参数。

内容的提问来源于stack exchange，提问作者omer blechman