Dosyalar ve toplu işler
Mesaj Toplu İşlemini (Batch) Getir
Bir Mesaj Toplu İşleminin durumunu ve istek sayılarını getirir.
Genel Bakış
Kuruluşunuz tarafından oluşturulan bir Mesaj Toplu İşleminin durumunu, istek sayılarını ve zaman damgalarını döndürür. processing_status değeri ended olana kadar bu uç noktayı sorgulayın, ardından sonuçları alın.
Notlar
processing_statusdeğeriin_progress,cancelingveyaendedolabilir.results_url, toplu işlem sona erene kadarnulldeğerindedir.- Mevcut olmayan veya silinmiş bir toplu işlem
404hatası döndürür. Henüz okunmaya hazır olmayan bir toplu işlem409hatası döndürebilir; daha sonra tekrar deneyin.
İstek
curl -X GET "https://api.tokenlab.sh/v1/messages/batches/msgbatch_01ABC123" \
-H "x-api-key: sk-your-api-key" \
-H "anthropic-version: 2023-06-01"Yanıt
{
"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"
}Önemli alanlar
processing_statusstring
in_progress, canceling veya ended.request_countsobject
processing, succeeded, errored, canceled veya expired durumundaki isteklerin sayısı.ended_atstring|null
İşlemin sona erdiği zaman veya
null.cancel_initiated_atstring|null
İptal isteğinin kabul edildiği zaman veya
null.results_urlstring|null
Sonuçların URL'si veya
null.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
message_batch_id*string
Mesaj toplu iş tanımlayıcısı
Yanıt
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json