Tệp và lô
Liệt kê các Batch
Liệt kê các batch trong Workspace hiện tại.
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:
20Số 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:
descasc hoặc desc, theo thời gian tạo.Yêu cầu
curl -X GET "https://api.tokenlab.sh/v1/batches?limit=20" \
-H "Authorization: Bearer sk-your-api-key"Phản hồi
{
"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 vi
1 <= value <= 100mặc định
20after?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