# 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 un appel à l’API distinct pour chaque opération, au risque de déclencher des limites d’appels, vous pouvez charger un fichier contenant toutes vos opérations et laisser Stripe les traiter de manière asynchrone. Utilisez le traitement par lots pour les migrations ponctuelles, les mises à jour en masse ou toute opération nécessitant le traitement de nombreuses ressources.

## Quand utiliser le traitement par lots*

Le traitement par lots* fonctionne bien pour&nbsp;:

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

Le traitement par lots ne fonctionne pas bien pour&nbsp;:

- Opérations nécessitant une réponse synchrone immédiate.
- Traitement en temps réel avec des exigences de délais serrés.
- Une seule requête à l’API.
- Des flux séquentiels dans lesquels une requête dépend du résultat d’une autre, par exemple la création de clients, puis de leurs abonnements. Exécutez plutôt chaque étape dans un lot distinct. Pour en savoir plus, consultez la page [Créer des objets associés dans plusieurs lots](https://docs.stripe.com/batch-api/create.md#create-related-objects-across-batches).
- Plusieurs mises à jour du même objet dans un seul lot. Les traitements par lots ne garantissent pas l’ordre de traitement, de sorte que l’état final de l’objet est imprévisible.

## Fonctionnement du traitement par lots

Chaque traitement par lots suit quatre étapes, décrites en détail dans la section [Exécuter un traitement par lots](https://docs.stripe.com/batch-api/create.md)&nbsp;:

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. [Charger le fichier d’entrée](https://docs.stripe.com/batch-api/create.md#upload-the-input-file) contenant vos requêtes.
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&nbsp;:

- Les fichiers d’entrée sont limités à 5&nbsp;Go. Si vous devez traiter un fichier plus volumineux, répartissez-le sur plusieurs traitements par lots.

- Les traitements par lots prennent uniquement en charge les fichiers JSONL (JSON délimité par des retours à la ligne). Ils n’acceptent pas les fichiers CSV ni d’autres formats.

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

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

- Les traitements par lots ne garantissent pas l’ordre de traitement, et le fichier de résultats ne suit pas l’ordre du fichier d’entrée. Utilisez le champ `id` pour associer chaque résultat à sa requête.

- Les traitements par lots ont une durée de traitement maximale de 7&nbsp;jours. Les traitements qui dépassent cette limite passent au statut `timeout`, avec des résultats partiels disponibles.

- Les traitements par lots ont une limite par défaut de deux millions de lignes par exécution, avec des limites inférieures pour certains [endpoints pris en charge](https://docs.stripe.com/batch-api/supported-endpoints.md). Les traitements qui dépassent la limite de leur endpoint échouent lors de la validation sans traiter aucune requête. Pour traiter un volume supérieur, [répartissez la charge de travail en plusieurs traitements par lots séquentiels](https://docs.stripe.com/batch-api/best-practices.md#split-large-workloads). Si vous avez besoin d’une capacité supérieure, contactez [le service de support Stripe](https://support.stripe.com/contact).

- Les résultats peuvent être téléchargés pendant 30&nbsp;jours après la fin du traitement. Chaque fois que vous récupérez le traitement par lots, Stripe renvoie une nouvelle URL de téléchargement.

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

- Vous devez charger le fichier d’entrée à l’aide d’une requête HTTP `PUT` vers l’URL de chargement. Cette URL n’accepte pas d’autres méthodes, comme `POST`.
