TokenLab

파일 및 배치

배치 목록 조회

현재 Workspace의 배치 목록을 조회합니다.

GET
/v1/batches

개요

현재 Workspace에서 POST /v1/batches를 통해 생성된 배치를 최신순으로 반환합니다. 메시지 배치는 메시지 배치 목록 조회에서 조회할 수 있습니다.

쿼리 파라미터

limitintegerquery기본값: 20
반환할 배치의 수(1~100)입니다.
afterstringquery
배치 ID 커서: 이 ID 이후의 배치를 반환합니다. 이전 페이지의 last_id를 사용하세요. before와 함께 사용할 수 없습니다.
beforestringquery
배치 ID 커서: 이 ID 이전의 배치를 반환합니다. after와 함께 사용할 수 없습니다.
orderstringquery기본값: desc
생성 시간 기준 asc 또는 desc입니다.

예시

요청

cURL
curl -X GET "https://api.tokenlab.sh/v1/batches?limit=20" \
  -H "Authorization: Bearer sk-your-api-key"

응답 예시

응답

200 OK
{
  "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
기본값20
after?string

배치 ID 커서: 이 배치 이후의 배치를 반환합니다. before와 함께 사용할 수 없습니다.

before?string

배치 ID 커서: 이 배치 이전의 배치를 반환합니다. after와 함께 사용할 수 없습니다.

order?string

생성 시간 기준 정렬 순서입니다.

기본값"desc"

허용 값

  • "asc"
  • "desc"

응답

application/json

application/json

application/json