TokenLab

Fichiers & lots

Lister les lots de messages

Liste les lots de messages créés par votre organisation.

GET
/v1/messages/batches

Aperçu

Renvoie les lots de messages créés par votre organisation via cette API, du plus récent au plus ancien. La liste affiche le statut que TokenLab a enregistré en dernier pour chaque lot. Pour vérifier un lot spécifique dès maintenant, récupérez-le.

Remarques

  • limit est compris entre 1 et 1000 et est défini par défaut à 20.
  • Pour paginer, transmettez after_id (lots plus anciens) ou before_id (lots plus récents) avec un ID de lot provenant de la liste. Ne transmettez pas les deux. TokenLab renvoie une erreur 400 pour un ID inconnu ou pour tout autre paramètre de requête.
  • Les lots supprimés ne sont pas listés.
  • has_more est true lorsque d'autres lots suivent.

Exemple

Requête

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"

Exemple de réponse

Réponse

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
}

Champs importants

dataarray
Lots de messages, du plus récent au plus ancien.
first_idstring|null
ID du premier lot dans data.
last_idstring|null
ID du dernier lot dans data.
has_moreboolean
D'autres lots sont disponibles lorsque has_more est vrai.

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 requête

before_id?string

Renvoie les lots avant cet ID de lot. Ne peut pas être combiné avec after_id.

after_id?string

Renvoie les lots après cet ID de lot. Ne peut pas être combiné avec before_id.

limit?integer

Nombre maximum de lots à retourner

Plage1 <= value <= 1000
par défaut20

Réponse

application/json

application/json

application/json

application/json

application/json

application/json

application/json