TokenLab

Tệp và lô

Liệt kê các Batch

Liệt kê các batch trong Workspace hiện tại.

GET
/v1/batches

Tổng quan

Trả về các batch được tạo thông qua POST /v1/batches trong Workspace hiện tại, mới nhất trước. Message Batches được liệt kê bởi Liệt kê Message Batches.

Tham số truy vấn

limitintegerquerymặc định: 20
Số lượng batch cần trả về, từ 1 đến 100.
afterstringquery
Con trỏ Batch ID: trả về các batch sau batch này. Sử dụng last_id của trang trước. Không thể kết hợp với before.
beforestringquery
Con trỏ Batch ID: trả về các batch trước batch này. Không thể kết hợp với after.
orderstringquerymặc định: desc
asc hoặc desc, theo thời gian tạo.

Ví dụ

Yêu cầu

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

Ví dụ phản hồi

Phản hồi

200 OK
{
  "object": "list",
  "data": [{ "id": "batch_abc123", "object": "batch", "status": "completed" }],
  "first_id": "batch_abc123",
  "last_id": "batch_abc123",
  "has_more": false
}

Các trường quan trọng

objectstring
Luôn là list.
dataarray
Các batch.
statusstring
Trạng thái của từng batch.
has_moreboolean
Có thêm kết quả khi has_more là true.

Xác thực

BearerAuth
AuthorizationBearer <token>

Xác thực bằng Khóa API. Tạo hoặc quản lý khóa API trong Dashboard > API > API Keys.

Vị trí: header

Tham số truy vấn

limit?integer

Số lượng batch cần trả về. Mặc định là 20.

Phạm vi1 <= value <= 100
mặc định20
after?string

Con trỏ ID batch: trả về các batch sau batch này. Không thể kết hợp với before.

before?string

Con trỏ ID batch: trả về các batch trước batch này. Không thể kết hợp với after.

order?string

Thứ tự sắp xếp theo thời gian tạo.

mặc định"desc"

Giá trị hợp lệ

  • "asc"
  • "desc"

Phản hồi

application/json

application/json

application/json