工作原理
响应格式
示例:对会话进行分页
第一页
下一页
end_cursor 值:
汇总所有结果
从基于偏移量的分页迁移
offset/limit 替换为 after/first:
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Devin API 中基于游标的分页工作原理
| Parameter | Type | Description |
|---|---|---|
first | integer | 每页返回的最大项目数(默认值因接口而异) |
after | string | 上一个响应返回的不透明游标。获取第一页时省略该参数 |
{
"items": [...],
"has_next_page": true,
"end_cursor": "eyJsYXN0X2lkIjoiYWJjMTIzIn0=",
"total": 142
}
| 字段 | 说明 |
|---|---|
items | 当前页的结果数组 |
has_next_page | 如果还有更多结果,则为 true |
end_cursor | 将此作为 after 参数传入,以获取下一页。当 has_next_page 为 false 时为 null |
total | 匹配项的总数(出于性能原因,某些端点可能会省略该字段) |
curl "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions?first=10" \
-H "Authorization: Bearer $DEVIN_API_KEY"
end_cursor 值:
curl "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions?first=10&after=eyJsYXN0X2lkIjoiYWJjMTIzIn0=" \
-H "Authorization: Bearer $DEVIN_API_KEY"
import os
import requests
org_id = os.environ["DEVIN_ORG_ID"]
url = f"https://api.devin.ai/v3/organizations/{org_id}/sessions"
headers = {"Authorization": f"Bearer {os.environ['DEVIN_API_KEY']}"}
all_sessions = []
cursor = None
while True:
params = {"first": 50}
if cursor:
params["after"] = cursor
response = requests.get(url, headers=headers, params=params).json()
all_sessions.extend(response["items"])
if not response.get("has_next_page"):
break
cursor = response["end_cursor"]
print(f"Fetched {len(all_sessions)} sessions")
offset/limit 替换为 after/first:
# 之前 (v1/v2)
curl ".../v1/sessions?offset=50&limit=25"
# 之后
curl ".../v3/organizations/{org_id}/sessions?first=25&after=CURSOR_FROM_PREVIOUS_PAGE"
