Berkas & batch

Mencantumkan Batch Pesan

Mencantumkan Batch Pesan yang dibuat oleh organisasi Anda.

GET
/v1/messages/batches

Gambaran Umum

Mengembalikan Batch Pesan yang dibuat oleh organisasi Anda melalui API ini, diurutkan dari yang terbaru. Daftar ini menampilkan status yang terakhir kali dicatat oleh TokenLab untuk setiap batch. Untuk memeriksa satu batch sekarang, ambil batch tersebut.

Catatan

  • limit bernilai 1 hingga 1000 dan default-nya adalah 20.
  • Untuk melakukan paging, kirimkan after_id (batch yang lebih lama) atau before_id (batch yang lebih baru) dengan ID batch dari daftar. Jangan mengirimkan keduanya. TokenLab akan mengembalikan 400 untuk ID yang tidak dikenal atau untuk parameter kueri lainnya.
  • Batch yang dihapus tidak akan dicantumkan.
  • has_more bernilai true jika masih ada batch berikutnya.

Contoh

Permintaan

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"

Contoh respons

Respons

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
}

Bidang penting

dataarray
Batch pesan, diurutkan dari yang terbaru.
first_idstring|null
ID dari batch pertama dalam data.
last_idstring|null
ID dari batch terakhir dalam data.
has_moreboolean
Batch lainnya tersedia jika has_more bernilai true.

Otorisasi

BearerAuth
AuthorizationBearer <token>

Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.

Lokasi: header

Parameter query

before_id?string

Mengembalikan batch sebelum ID batch ini. Tidak dapat digabungkan dengan after_id.

after_id?string

Mengembalikan batch setelah ID batch ini. Tidak dapat digabungkan dengan before_id.

limit?integer

Jumlah maksimum batch yang akan dikembalikan

Rentang1 <= value <= 1000
bawaan20

Respons

application/json

application/json

application/json

application/json

application/json

application/json

application/json