Sentry API分页实现疑问：请求仅返回100条结果无分页标识

问题详情 #

调用Sentry API获取项目问题时，仅返回100条结果，但UI中显示有更多数据。根据官方逻辑需要使用分页，但响应体中找不到rel="previous"这类分页标识，不清楚请求中缺失了什么。

调用代码 #

_URL = "https://sentry.io/api/0/projects/aaaa-7y/aaaa/issues/"
headers = {'Authorization': 'Bearer 11111111111111111111111', 'Content-Type': 'application/json'}
params = {"statsPeriod":"24h", 'cursor':'100:-1:1'}

r = requests.get(url = _URL, headers = headers, params=params, verify=False) 
data = r.json()

响应示例（开头部分） #

[{'id': '',
  'shareId': None,
  'shortId': 'aaaa-8Y',
  'title': '<unknown>',
  'culprit': '',
  'permalink': 'https://sentry.io/organizations/7777-7y/issues/777777/',
  'logger': None,
  'level': 'error',
  'status': 'unresolved',
  'isPublic': False,
  'platform': 'javascript',
  'project': {'id': '7777',
   'name': 'aaaa',
   'slug': 'aaaa',
   'platform': 'react-native'},
  'type': 'error',
  'metadata': {'value': 'aaa: Variable "$input" got invalid value { aa: "google-aaaa|aaaaa", uri: "https://storage.googleapis.com/glue-storage-prod/aa/aa-e267-4bfe-90bd-aaa.png", imageWidth: 1169, imageHeight: 253...',
   'display_title_with_tree_label': False},
  'numComments': 0,
  'assignedTo': None,
  'isBookmarked': False,
  'isSubscribed': False,
  'subscriptionDetails': None,
  'hasSeen': False,
  'issueType': 'error',
  'issueCategory': 'error',
  'isUnhandled': False,
  'count': '2',
  'userCount': 0,
  'firstSeen': '2022-08-04T11:47:52.295000Z',
  'lastSeen': '2022-08-10T07:24:18.899000Z'},

问题原因与解决方案 #

核心问题 #

Sentry API的分页信息不在响应体中，而是存放在HTTP响应头的Link字段里，你之前只解析了响应体，忽略了响应头的内容。

具体修正步骤 #

1. 移除手动指定的cursor参数：初始请求无需手动设置cursor，让API返回默认的第一页数据及分页标记。
2. 读取响应头的Link字段：该字段包含next/previous的分页链接，格式类似 <https://sentry.io/api/0/projects/xxx/issues/?cursor=xxx>; rel="next"。
3. 循环请求直到没有下一页：每次请求后提取next对应的cursor，更新参数后发起下一次请求，直到Link头中不再包含rel="next"。

修正后的代码示例 #

import requests

_URL = "https://sentry.io/api/0/projects/aaaa-7y/aaaa/issues/"
headers = {'Authorization': 'Bearer 11111111111111111111111', 'Content-Type': 'application/json'}
params = {"statsPeriod":"24h"}

all_issues = []
while True:
    response = requests.get(url=_URL, headers=headers, params=params, verify=False)
    page_data = response.json()
    all_issues.extend(page_data)
    
    # 检查是否有下一页
    link_header = response.headers.get('Link')
    if not link_header or 'rel="next"' not in link_header:
        break
    
    # 提取下一页的cursor参数
    next_segment = [seg for seg in link_header.split(',') if 'rel="next"' in seg][0]
    next_cursor = next_segment.split('cursor=')[1].split('>')[0]
    params['cursor'] = next_cursor

print(f"共获取到 {len(all_issues)} 条问题数据")

额外提示 #

• 手动设置cursor容易出错，建议由API返回的分页标记来控制请求流程。
• 若仍无法获取Link头，检查API令牌的权限是否足够访问该项目的所有数据，或确认请求的项目slug是否正确。

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