REST: Exportstatus, Download und Batches

Einen Auftrag abfragen, die CSV holen und Exporte über 50.000 Zeilen behandeln.

Ein einmal angelegter Export bleibt für immer abrufbar. Eine abgerissene Verbindung oder ein abgestürztes Skript heißt nie, dass ein schon berechneter Export verloren ist.

Einzelner Auftrag

GET  /api/mcp/exports/{job_id}
GET  /api/mcp/exports/{job_id}/download

Die Statusantwort meldet den Zustand, verifizierte gegenüber allen Zeilen, einen Fortschritt in Prozent und ob die Datei schon herunterladbar ist. Frag alle paar Sekunden ab; kleine Exporte sind meist in ein paar Minuten fertig. Nimm lieber den Download-Pfad aus der Statusantwort, statt selbst einen zu bauen.

Batches über 50.000 Zeilen

GET  /api/mcp/export-batches/{batch_id}

Ein Batch meldet fertige gegenüber allen Teilen und listet jeden Teil mit eigenem Download-Pfad. Lade sie einzeln herunter; in der CLI gilt eine Datei pro Teil, benannt leads-part1.csv, leads-part2.csv und so weiter.

Antwort des Exportstatus mit Fortschritt und dem Hinweis, ob die Datei herunterladbar ist

Die Abkürzung über die CLI

npx argorant export status 12345
npx argorant export download 12345 -o leads.csv
npx argorant export status 987 --batch
npx argorant export download 987 --batch -o leads.csv

Status und Download sind kostenlos. Einen schon bezahlten Export erneut herunterzuladen kostet nie wieder Credits, ein Wiederherstellungsversuch ist also immer gefahrlos.

Wenn ein Auftrag einen Fehlerzustand meldet, enthält die Antwort eine Fehlermeldung. Für Zeilen, die nie erzeugt wurden, wird nichts berechnet.