# Batch-Aufträge

Mehrere API-Anfragen asynchron mit einem einzigen Datei-Upload verarbeiten.

Die Batch Jobs-API ermöglicht die Durchführung von Massenoperationen auf Stripe-Ressourcen. Anstatt für jede einzelne Operation eine separate API-Anfrage zu senden, die Begrenzungen auslösen könnte, können Sie eine Datei mit allen Vorgängen hochladen und Stripe diese asynchron verarbeiten lassen. Verwenden Sie dies für einmalige Migrationen, Massenaktualisierungen oder jede Operation, die die Verarbeitung vieler Ressourcen erfordert.

## Wann Sie Batch-Aufträge verwenden sollten

Batch-Aufträge funktionieren gut für:

- **Massenmigrationen**: Verschieben großer Mengen von Abonnements in neue Abrechnungsmodi.
- **Massenaktualisierungen**: Gleichzeitige Aktualisierung mehrerer Konten oder Abonnements.

Batch-Aufträge eignen sich nicht für:

- Vorgänge, die eine sofortige synchrone Antwort erfordern.
- Echtzeitverarbeitung mit engen zeitlichen Anforderungen.
- Ein einzelner asynchroner Aufruf.

Führen Sie zum die folgenden Schritte aus, um einen Batch-Auftrag zu verarbeiten:

1. [Erstellen Sie einen Batch-Auftrag](https://docs.stripe.com/batch-api/create.md#create-a-batch-job) und geben Sie den Ziel-API-Endpoint an.
2. [Laden Sie die Eingabedatei](https://docs.stripe.com/batch-api/create.md#upload-the-input-file) mit Ihren Batch-Anfragen hoch.
3. [Überwachen Sie den Auftragsstatus](https://docs.stripe.com/batch-api/create.md#monitor-job-status) über Webhooks oder Abfragen.
4. [Ergebnisse herunterladen](https://docs.stripe.com/batch-api/create.md#download-the-results).

## Unterstützte Endpoints

Die Batch Jobs-API unterstützt viele Endpoints in verschiedenen Stripe-Ressourcen. Jeder Batch-Auftrag zielt auf einen einzelnen Endpoint ab und alle Anfragen im Stapel werden an diesen Endpoint gesendet.

Eine vollständige Liste der verfügbaren Endpoints finden Sie unter [Unterstützte Endpoints](https://docs.stripe.com/batch-api/supported-endpoints.md).

## Einschränkungen

Prüfen Sie die folgenden Einschränkungen:

- Batch-Dateien sind auf 5 GB begrenzt. Wenn Sie eine größere Datei für ein höheres Volumen an Anfragen verarbeiten müssen, teilen Sie sie in mehrere Batches auf.

- Batch-Aufträge unterstützen nur JSONL-Dateien (newline-delimited JSON). Batch-Aufträge akzeptieren keine CSV- oder andere Formate.

- Batch-Anfragen können nur `POST` oder `DELETE` verwenden. Batch-Aufträge unterstützen `GET` nicht.

- Alle Anfragen in einem Batch müssen auf denselben API-Endpoint abzielen.

- Batch-Aufträge garantieren keine bestimmte Reihenfolge der Anfrageverarbeitung.

- Stapelverarbeitungen haben eine maximale Verarbeitungsdauer von 7 Tagen. Aufträge, die dieses Limit überschreiten, wechseln in den Status `Timeout`, wobei Teilergebnisse verfügbar sind.

- Für Stapelverarbeitungen gilt eine Obergrenze von maximal 2 Millionen Zeilen pro Durchlauf. Vorgänge, die diesen Grenzwert überschreiten, schlagen bei der Validierung fehl und erstellen keine Ressourcen. Teilen Sie größere Workloads in mehrere Stapelverarbeitungen von jeweils höchstens 2 Millionen Zeilen auf und übermitteln Sie diese nacheinander. Warten Sie, bis ein Vorgang abgeschlossen ist, bevor Sie den nächsten erstellen. Die gleichzeitige Ausführung mehrerer großer Stapelverarbeitungen kann langsamer und unzuverlässiger sein als die Ausführung derselben Aufgabe in aufeinanderfolgenden Vorgängen. Wenn Sie mehr Kapazität benötigen, wenden Sie sich an den [Stripe-Support](https://support.stripe.com/contact).

- Die Ergebnisse können 7 Tage nach Abschluss des Auftrags heruntergeladen werden.

- Die Upload-URL läuft 5 Minuten nach der Erstellung des Auftrags ab. Nach Ablauf dieser Frist wechselt der Auftrag in den Status `upload_timeout` und Sie müssen einen neuen Auftrag erstellen.

- Laden Sie die Datei mit einer direkten HTTP-`PUT`-Anfrage an die vorsignierte URL hoch.