파일 및 배치
배치 목록 조회
현재 Workspace의 배치 목록을 조회합니다.
개요
현재 Workspace에서 POST /v1/batches를 통해 생성된 배치를 최신순으로 반환합니다. 메시지 배치는 메시지 배치 목록 조회에서 조회할 수 있습니다.
쿼리 파라미터
limitintegerquery기본값:
20반환할 배치의 수(1~100)입니다.
afterstringquery
배치 ID 커서: 이 ID 이후의 배치를 반환합니다. 이전 페이지의
last_id를 사용하세요. before와 함께 사용할 수 없습니다.beforestringquery
배치 ID 커서: 이 ID 이전의 배치를 반환합니다.
after와 함께 사용할 수 없습니다.orderstringquery기본값:
desc생성 시간 기준
asc 또는 desc입니다.요청
curl -X GET "https://api.tokenlab.sh/v1/batches?limit=20" \
-H "Authorization: Bearer sk-your-api-key"응답
{
"object": "list",
"data": [{ "id": "batch_abc123", "object": "batch", "status": "completed" }],
"first_id": "batch_abc123",
"last_id": "batch_abc123",
"has_more": false
}주요 필드
objectstring
항상
list입니다.dataarray
배치 목록입니다.
statusstring
각 배치의 상태입니다.
has_moreboolean
has_more가 true이면 추가 결과가 있음을 나타냅니다.인증
BearerAuth AuthorizationBearer <token>
API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.
위치: header
쿼리 매개변수
limit?integer
반환할 배치 수입니다. 기본값은 20입니다.
범위
1 <= value <= 100기본값
20after?string
배치 ID 커서: 이 배치 이후의 배치를 반환합니다. before와 함께 사용할 수 없습니다.
before?string
배치 ID 커서: 이 배치 이전의 배치를 반환합니다. after와 함께 사용할 수 없습니다.
order?string
생성 시간 기준 정렬 순서입니다.
기본값
"desc"허용 값
- "asc"
- "desc"
응답
application/json
application/json
application/json