TokenLab

Tệp và lô

Truy xuất Batch

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

GET
/v1/batches/{batch_id}

Tổng quan

Trả về trạng thái batch, số lượng yêu cầu đã hoàn thành và thất bại, cùng với các ID tệp kết quả.

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 yêu cầu 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