Dosyalar ve toplu işler

Batch Getir

Bir batch için geçerli durumu, sayıları ve sonuç dosyalarını getirir.

GET
/v1/batches/{batch_id}

Genel Bakış

Batch durumunu, istek sayılarını ve sonuç dosya ID'lerini döndürür. Bilinmeyen bir batch ID'si veya başka bir Workspace'e ait bir batch 404 batch_not_found döndürür.

status değeri validating, queued, in_progress, finalizing, completed, failed, cancelling, cancelled veya expired değerlerinden biridir. status değeri completed olduğunda sonuç dosyaları hazır hale gelir; bunları Dosya İçeriğini Getir ile okuyabilirsiniz.

Örnek

İstek

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

Yanıt örneği

Yanıt

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 }
}

Önemli alanlar

request_countsobject
Toplam, tamamlanan, başarısız olan ve iptal edilen isteklerin sayıları.
output_file_idstring|null
Başarılı sonuç dosyası ID'si.
error_file_idstring|null
Başarısız sonuç dosyası ID'si.

Yetkilendirme

BearerAuth
AuthorizationBearer <token>

API Anahtarı kimlik doğrulaması. API anahtarlarını Dashboard > API > API Keys bölümünden oluşturun veya yönetin.

Konum: header

Yol parametreleri

batch_id*string

Yanıt

application/json

application/json

application/json