Fichiers & lots
Lister les lots de messages
Liste les lots de messages créés par votre organisation.
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
limitest compris entre 1 et 1000 et est défini par défaut à 20.- Pour paginer, transmettez
after_id(lots plus anciens) oubefore_id(lots plus récents) avec un ID de lot provenant de la liste. Ne transmettez pas les deux. TokenLab renvoie une erreur400pour un ID inconnu ou pour tout autre paramètre de requête. - Les lots supprimés ne sont pas listés.
has_moreesttruelorsque d'autres lots suivent.
Requête
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"Réponse
{
"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
Plage
1 <= value <= 1000par défaut
20Réponse
application/json
application/json
application/json
application/json
application/json
application/json
application/json