Dateien & Batch-Jobs

Batches auflisten

Batches im aktuellen Workspace auflisten.

GET
/v1/batches

Übersicht

Gibt die über POST /v1/batches erstellten Batches im aktuellen Workspace zurück, die neuesten zuerst. Message Batches werden über Message Batches auflisten aufgeführt.

Query-Parameter

limitintegerqueryStandard: 20
Anzahl der zurückzugebenden Batches, von 1 bis 100.
afterstringquery
Batch-ID-Cursor: Gibt Batches nach diesem zurück. Verwenden Sie die last_id der vorherigen Seite. Kann nicht mit before kombiniert werden.
beforestringquery
Batch-ID-Cursor: Gibt Batches vor diesem zurück. Kann nicht mit after kombiniert werden.
orderstringqueryStandard: desc
asc oder desc, nach Erstellungszeitpunkt.

Beispiel

Anfrage

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

Antwortbeispiel

Antwort

200 OK
{
  "object": "list",
  "data": [{ "id": "batch_abc123", "object": "batch", "status": "completed" }],
  "first_id": "batch_abc123",
  "last_id": "batch_abc123",
  "has_more": false
}

Wichtige Felder

objectstring
Immer list.
dataarray
Batches.
statusstring
Status jedes Batches.
has_moreboolean
Weitere Ergebnisse sind verfügbar, wenn has_more true ist.

Autorisierung

BearerAuth
AuthorizationBearer <token>

API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.

Ort: header

Abfrageparameter

limit?integer

Anzahl der zurückzugebenden Batches. Standard 20.

Bereich1 <= value <= 100
Standard20
after?string

Batch-ID-Cursor: gibt Batches nach diesem zurück. Kann nicht mit before kombiniert werden.

before?string

Batch-ID-Cursor: gibt Batches vor diesem zurück. Kann nicht mit after kombiniert werden.

order?string

Sortierreihenfolge nach Erstellungszeit.

Standard"desc"

Zulässige Werte

  • "asc"
  • "desc"

Antwort

application/json

application/json

application/json