TokenLab

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.

GET
/v1/messages/batches

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 ý

  • limit nằ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ặc before_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ề 400 nế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_more là true khi vẫn còn các batch tiếp theo.

Ví dụ

Yêu cầu

cURL
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"

Ví dụ phản hồi

Phản hồi

200 OK
{
  "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 vi1 <= value <= 1000
mặc định20

Phản hồi

application/json

application/json

application/json

application/json

application/json

application/json

application/json