TokenLab

Fichiers & lots

Récupérer un batch

Récupère le statut actuel, les décomptes et les fichiers de résultats d'un batch.

GET
/v1/batches/{batch_id}

Vue d'ensemble

Renvoie le statut du batch, le décompte des requêtes et les ID des fichiers de résultats. Un ID de batch inconnu, ou un batch d'un autre Workspace, renvoie 404 batch_not_found.

status prend l'une des valeurs suivantes : validating, queued, in_progress, finalizing, completed, failed, cancelling, cancelled ou expired. Les fichiers de résultats sont prêts lorsque status est completed ; lisez-les avec Récupérer le contenu d'un fichier.

Exemple

Requête

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

Exemple de réponse

Réponse

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

Champs importants

request_countsobject
Décompte des requêtes totales, terminées, échouées et annulées.
output_file_idstring|null
ID du fichier de résultats des requêtes réussies.
error_file_idstring|null
ID du fichier de résultats des requêtes échouées.

Autorisation

BearerAuth
AuthorizationBearer <token>

Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.

Emplacement: header

Paramètres de chemin

batch_id*string

Réponse

application/json

application/json

application/json