TokenLab

Tệp và lô

Truy xuất Batch

Truy xuất trạng thái hiện tại, số lượng request và các tệp kết quả cho một batch.

GET
/v1/batches/{batch_id}

Tổng quan

Trả về trạng thái của batch, số lượng request và ID của các tệp kết quả. ID batch không xác định hoặc batch thuộc về một Workspace khác sẽ trả về 404 batch_not_found.

status là một trong các giá trị validating, queued, in_progress, finalizing, completed, failed, cancelling, cancelled hoặc expired. Các tệp kết quả sẵn sàng khi status là completed; đọc các tệp này bằng Truy xuất nội dung tệp.

Ví dụ

Yêu cầu

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

Ví dụ phản hồi

Phản hồi

200 OK
{
  "id": "batch_abc123",
  "object": "batch",
  "status": "completed",
  "input_file_id": "file_abc123",
  "output_file_id": "file_out123",
  "error_file_id": "file_err123",
  "request_counts": { "total": 100, "completed": 98, "failed": 2 }
}

Các trường quan trọng

request_countsobject
Số lượng các request tổng cộng, đã hoàn thành, thất bại và đã hủy.
output_file_idstring|null
ID tệp kết quả thành công.
error_file_idstring|null
ID tệp kết quả thất bại.

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ố đường dẫn

batch_id*string

Phản hồi

application/json

application/json

application/json