# Traitement par lots*

Traitez plusieurs requêtes API de manière asynchrone avec un seul chargement de fichier.

L’API Batch Jobs vous permet d’effectuer des opérations en masse sur les ressources Stripe. Au lieu d’effectuer des appels API individuels pour chaque opération - ce qui peut entraîner des limites de taux - vous pouvez importer un fichier contenant l’ensemble de vos opérations et laisser Stripe les traiter de manière asynchrone. Utilisez cette API pour des migrations ponctuelles, des mises à jour en masse ou toute opération nécessitant le traitement d’un grand nombre de ressources.

## Quand utiliser le traitement par lots*

Le traitement par lots* fonctionne bien pour :

- **Migrations groupées** : transférez des quantités importantes d’abonnements vers de nouveaux modes de facturation.
- **Mises à jour en masse** : mettez à jour plusieurs comptes ou abonnements en même temps.

Le traitement par lots ne fonctionne pas bien pour :

- Opérations nécessitant une réponse synchrone immédiate.
- Traitement en temps réel avec des exigences de délais serrés.
- Un seul appel asynchrone.

Pour effectuer un traitement par lots, procédez comme suit :

1. [Créez un traitement par lot](https://docs.stripe.com/batch-api/create.md#create-a-batch-job) et spécifiez l’endpoint API cible.
2. [Importez le fichier d’entrée](https://docs.stripe.com/batch-api/create.md#upload-the-input-file) contenant vos requêtes par lot.
3. [Suivez l’état du traitement](https://docs.stripe.com/batch-api/create.md#monitor-job-status) via des webhooks ou en interrogeant régulièrement l’API.
4. [Télécharger les résultats](https://docs.stripe.com/batch-api/create.md#download-the-results).

## Endpoints pris en charge

L’API de traitement par lots prend en charge de nombreux endpoints pour les ressources Stripe. Chaque traitement par lots cible un seul endpoint, et toutes les requêtes du lot sont dirigées vers cet endpoint.

Pour obtenir la liste complète des endpoints disponibles, consultez [Endpoints pris en charge](https://docs.stripe.com/batch-api/supported-endpoints.md).

## Limites

Vérifiez les limites suivantes :

- Les fichiers par lots sont limités à 5 Go. Si vous devez traiter un fichier plus volumineux pour un volume plus élevé de requêtes, fractionnez-le en plusieurs lots.

- Le traitement par lots* prend uniquement en charge les fichiers JSONL (JSON délimité par des sauts de ligne). Le traitement par lots n’accepte pas les formats CSV ou autres.

- Les requêtes d’un lot peuvent uniquement utiliser `POST` ou `DELETE`. Le traitement par lots* ne prend pas en charge `GET`.

- Toutes les requêtes d’un lot doivent cibler le même endpoint API.

- Le traitement par lots* ne garantit pas l’ordre de traitement des requêtes.

- La durée maximale du traitement par lots* est de 24 heures. Les traitements dépassant cette limite passent à l’état `timeout`, avec des résultats partiels disponibles.

- Les résultats sont téléchargeables pendant 7 jours après la fin du traitement.

- L’URL de téléchargement expire 5 minutes après la création de la tâche. Passé ce délai, la tâche passe à l’état `upload_timeout` et vous devez en créer un nouveau.

- Chargez le fichier avec une requête directe HTTP `PUT` à l’URL présignée.