Dosyalar ve toplu işler

Mesaj Gruplarını Listele

Kuruluşunuz tarafından oluşturulan Mesaj Gruplarını listeler.

GET
/v1/messages/batches

Genel Bakış

Kuruluşunuzun bu API aracılığıyla oluşturduğu Mesaj Gruplarını, en yeniden eskiye doğru sıralanmış şekilde döndürür. Liste, TokenLab'in her bir grup için kaydettiği son durumu gösterir. Bir grubu şimdi kontrol etmek için onu geri alın.

Notlar

  • limit değeri 1 ile 1000 arasındadır ve varsayılan olarak 20'dir.
  • Sayfalama yapmak için, listedeki bir grup kimliğiyle birlikte after_id (daha eski gruplar) veya before_id (daha yeni gruplar) parametrelerini gönderin. Her ikisini birden göndermeyin. TokenLab, bilinmeyen bir kimlik veya başka herhangi bir sorgu parametresi için 400 hatası döndürür.
  • Silinen gruplar listelenmez.
  • Daha fazla grup olduğunda has_more değeri true olur.

Örnek

İstek

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"

Yanıt örneği

Yanıt

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
}

Önemli alanlar

dataarray
Mesaj grupları, en yeniden eskiye doğru.
first_idstring|null
data içindeki ilk grubun kimliği.
last_idstring|null
data içindeki son grubun kimliği.
has_moreboolean
has_more değeri true olduğunda daha fazla grup mevcut demektir.

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

Sorgu parametreleri

before_id?string

Bu batch kimliğinden önceki batch'leri döndürür. after_id ile birleştirilemez.

after_id?string

Bu batch kimliğinden sonraki batch'leri döndürür. before_id ile birleştirilemez.

limit?integer

Döndürülecek maksimum toplu iş sayısı

Aralık1 <= value <= 1000
varsayılan20

Yanıt

application/json

application/json

application/json

application/json

application/json

application/json

application/json