Skip to main content
GET
Lädt die Einträge einer Lead-Liste als CSV- oder Excel-Datei herunter.
Erfordert einen Management-API-Schlüssel mit MANAGEMENT_API- (oder MANAGEMENT_API_SANDBOX-)Quota und die Berechtigung LEAD_GENERATION_ENTRY_CAN_VIEW, gesendet als roher Authorization-Header-Wert — siehe die Übersicht über die Management API.
string
erforderlich
Die lead_id der Lead-Liste.
string
Standard:"csv"
csv, xls oder xlsx.
string
Nur Einträge, die an oder nach diesem Datum erstellt wurden (YYYY-MM-DD).
string
Nur Einträge, die an oder vor diesem Datum erstellt wurden (YYYY-MM-DD).
string
Kommagetrennte Eintrags-UUIDs, um den Export auf eine bestimmte Auswahl zu beschränken — entspricht der Aktion „Ausgewählte herunterladen” im Dashboard. Ungültige UUIDs werden stillschweigend ignoriert statt abgelehnt.
Dieselbe Teilstring-Suche wie bei Lead-Einträge auflisten — entspricht „Gefilterte Ergebnisse herunterladen”.
Die Antwort ist ein Datei-Download (Content-Type: text/csv, oder der XLSX-MIME-Typ für xls/xlsx), kein JSON, mit Content-Disposition: attachment; filename=<LeadListName>-<timestamp>.<ext>.
Die exportierte Datei enthält immer eine tracking_id-Spalte, unabhängig von Tracking-Berechtigungen anderswo im Konto. Wenn ein einreichender QR-Code inzwischen gelöscht wurde, wird sein Spaltenwert als <qrid> (Deleted) dargestellt, statt den Export fehlschlagen zu lassen. Bei null übereinstimmenden Einträgen enthält die Datei dennoch eine Kopfzeile (abgeleitet aus den Fragebezeichnungen des Lead-Formulars), statt leer zu sein.
Bei einem Konto im kostenlosen Plan (plan_type 1) ist der Export auf 25 Zeilen begrenzt — wenn mehr Einträge übereinstimmten, werden zwei abschließende Zeilen angehängt, die auf das Limit hinweisen und zu einem Upgrade auffordern.
400 mit einem reinen Textkörper (nicht der Standard-DRF-Fehlerform), wenn file_format nicht csv, xls oder xlsx ist:
400

Verwandte Themen

Autorisierungen

Authorization
string
header
erforderlich

Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.

Antwort

200

CSV or XLSX file download.