목록, 페이지네이션 및 내보내기
목록 API는 커서 페이지네이션을 사용하며 페이지 크기와 생성 시간 필터를 공유합니다. 일부는 CSV 내보내기를 지원합니다.
핵심 사항
- limit은 1~100이고 기본값은 20입니다. 다음 페이지에는 마지막 객체 ID를 starting_after로 전달하세요.
- ending_before는 이전 페이지용이며 starting_after와 함께 사용할 수 없습니다. created[gte]와 created[lte]는 ISO-8601 또는 Unix 초를 받습니다.
- 지원 엔드포인트에서 format=csv로 대조용 파일을 내보낼 수 있습니다. 더 이상 페이지가 없을 때까지 커서를 따라가세요.
예시
json
{
"code": 200,
"message": "success",
"request_id": "req_9f2c1a7b4e8d0356c1ab77de90f4b215",
"data": {
"object": "list",
"resource": "order",
"has_more": true,
"url": "/v1/orders",
"data": [
{ "object": "order", "trade_no": "TRD_A1B2...", "status": "paid" },
{ "object": "order", "trade_no": "TRD_C3D4...", "status": "pending" }
]
}
}