Documentation Index
Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
Use this file to discover all available pages before exploring further.
Todos os endpoints de listagem nas APIs de Organização e Enterprise usam paginação baseada em cursor. Isso proporciona uma paginação consistente e eficiente, independentemente do tamanho do conjunto de resultados.
Cada endpoint de listagem aceita dois parâmetros de consulta:
| Parâmetro | Tipo | Descrição |
|---|
first | inteiro | Número máximo de itens a retornar por página (o padrão varia conforme o endpoint) |
after | string | Cursor opaco de uma resposta anterior. Omita na primeira página |
Respostas em lista incluem metadados de paginação:
{
"items": [...],
"has_next_page": true,
"end_cursor": "eyJsYXN0X2lkIjoiYWJjMTIzIn0=",
"total": 142
}
| Field | Description |
|---|
items | Array de resultados da página atual |
has_next_page | true se existirem mais resultados |
end_cursor | Passe-o como parâmetro after para obter a próxima página. null quando has_next_page é false |
total | Número total de itens correspondentes (pode ser omitido por alguns endpoints por motivos de desempenho) |
Exemplo: paginando sessões
curl "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions?first=10" \
-H "Authorization: Bearer $DEVIN_API_KEY"
Use o valor end_cursor da resposta anterior:
curl "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions?first=10&after=eyJsYXN0X2lkIjoiYWJjMTIzIn0=" \
-H "Authorization: Bearer $DEVIN_API_KEY"
Coletar todos os resultados
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")
Se você estiver migrando da API v1 ou v2, substitua offset/limit por after/first:
# Before (v1/v2)
curl ".../v1/sessions?offset=50&limit=25"
# After
curl ".../v3/organizations/{org_id}/sessions?first=25&after=CURSOR_FROM_PREVIOUS_PAGE"
A paginação baseada em cursor é mais confiável do que a paginação baseada em offset porque não é afetada por itens adicionados ou removidos entre as páginas.