Tệp và lô
Liệt kê các Batch tin nhắn
Liệt kê các Batch tin nhắn mà tổ chức của bạn đã tạo.
Tổng quan
Trả về các Batch tin nhắn mà tổ chức của bạn đã tạo thông qua API này, theo thứ tự mới nhất trước. Danh sách hiển thị trạng thái mà TokenLab đã ghi nhận lần cuối cho mỗi batch. Để kiểm tra một batch ngay bây giờ, hãy truy xuất nó.
Lưu ý
limitnằm trong khoảng từ 1 đến 1000 và mặc định là 20.- Để phân trang, hãy truyền
after_id(các batch cũ hơn) hoặcbefore_id(các batch mới hơn) cùng với một ID batch từ danh sách. Không gửi cả hai cùng lúc. TokenLab sẽ trả về400nếu ID không xác định hoặc nếu có bất kỳ tham số truy vấn nào khác. - Các batch đã xóa sẽ không được liệt kê.
has_morelàtruekhi vẫn còn các batch tiếp theo.
Yêu cầu
curl -X GET "https://api.tokenlab.sh/v1/messages/batches?limit=20" \
-H "x-api-key: sk-your-api-key" \
-H "anthropic-version: 2023-06-01"Phản hồi
{
"data": [
{
"id": "msgbatch_01ABC123",
"type": "message_batch",
"processing_status": "ended",
"request_counts": { "processing": 0, "succeeded": 2, "errored": 0, "canceled": 0, "expired": 0 },
"ended_at": "2026-11-01T10:20:00Z",
"created_at": "2026-11-01T10:00:00Z",
"expires_at": "2026-11-02T10:00:00Z",
"cancel_initiated_at": null,
"archived_at": null,
"results_url": "https://api.tokenlab.sh/v1/messages/batches/msgbatch_01ABC123/results"
}
],
"first_id": "msgbatch_01ABC123",
"last_id": "msgbatch_01ABC123",
"has_more": false
}Các trường quan trọng
dataarray
Các batch tin nhắn, theo thứ tự mới nhất trước.
first_idstring|null
ID của batch đầu tiên trong
data.last_idstring|null
ID của batch cuối cùng trong
data.has_moreboolean
Các batch khác sẽ khả dụng 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
before_id?string
Trả về các batch trước ID batch này. Không thể kết hợp với after_id.
after_id?string
Trả về các batch sau ID batch này. Không thể kết hợp với before_id.
limit?integer
Số lượng batch tối đa cần trả về
Phạm vi
1 <= value <= 1000mặc định
20Phản hồi
application/json
application/json
application/json
application/json
application/json
application/json
application/json