Dataset Uploads

Wie CSV-Daten in Everyn hochgeladen und zu einem dauerhaften Dataset verarbeitet werden.

Dataset Uploads verwandeln eine CSV-Datei in ein dauerhaftes Everyn Dataset. Die API akzeptiert direkte Multipart-CSV-Uploads bis 25 MiB, erstellt eine DatasetUpload-Ressource und verarbeitet das Dataset asynchron.

Dataset-Upload-Workflow

Upload erstellen:

curl -sS -X POST "$EVERYN_BASE_URL/v1/dataset-uploads" \
  -H "Authorization: Bearer $EVERYN_API_KEY" \
  -H "Idempotency-Key: upload-leads-001" \
  -F "sourceType=csv" \
  -F "sourceName=leads.csv" \
  -F 'metadata={"purpose":"sample-run"}' \
  -F "file=@./leads.csv;type=text/csv"

Upload pollen:

curl -sS "$EVERYN_BASE_URL/v1/dataset-uploads/upl_..." \
  -H "Authorization: Bearer $EVERYN_API_KEY"

Wichtige Felder:

Feld	Bedeutung
`id`	Stabile Upload-Ressourcen-ID mit Prefix `upl_`.
`status`	`processing`, `completed`, `failed` oder `expired`.
`datasetId`	Dauerhafte Dataset-ID nach Completion; vorher oder bei Failure `null`.
`sizeBytes` / `bytesReceived`	Ehrliche Byte-Zählung für den Direct Upload.
`failure`	Resource-lokale Fehlerdetails für fehlgeschlagene Uploads.

Direct-Multipart-Limit: 25 MiB Dateibytes.

Nur retrybare fehlgeschlagene Uploads retryen:

curl -sS -X POST "$EVERYN_BASE_URL/v1/dataset-uploads/upl_.../retry" \
  -H "Authorization: Bearer $EVERYN_API_KEY"

Nutze die generierte Dataset-Uploads-API-Referenz für Route-Details.