Datenexport herunterladen

GET /api/organization/data-export/{exportId}/download

Gibt eine vorsignierte URL für das Export-ZIP zurück. Die URL gilt 5 Minuten; der Object-Key selbst wird nie preisgegeben und der Storage-Bucket ist nicht durchsuchbar. Die Export-ID zu kennen ist also kein Zugriff — ein authentifizierter Administrator der besitzenden Organisation zu sein schon.

Query-Parameter

Beispiel (cURL)

BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"
EXPORT_ID="0f0f2f6a-2b3b-4a2f-9a7c-3e5f8c1d2b44"

# Direkt in die Datei
curl -L -o export.zip \
  "$BASE_URL/api/organization/data-export/$EXPORT_ID/download?redirect=1" \
  -H "Authorization: Bearer $TOKEN"

Antwort (Response)

{
  "url": "https://<bucket>.<region>.your-objectstorage.com/data-exports/org-12/0f0f2f6a-...zip?X-Amz-Signature=...",
  "expiresInSeconds": 300,
  "sizeBytes": 18446721,
  "filename": "uptimeify-export-0f0f2f6a-2b3b-4a2f-9a7c-3e5f8c1d2b44.zip"
}

Jeder Aufruf erhöht downloadCount und aktualisiert lastDownloadedAt am Export-Datensatz.

Häufige Fehler

• 400 User must belong to an organization wenn aus Session oder Token keine Organisation abgeleitet werden kann
• 401 Unauthorized wenn du nicht authentifiziert bist
• 403 Forbidden wenn deine Rolle die Organisation nicht verwalten darf
• 404 Export not found wenn die ID nicht zu deiner Organisation gehört
• 409 Export is not downloadable (data.code: exportNotReady) solange der Export in der Warteschlange, in Arbeit oder fehlgeschlagen ist
• 410 Export download window has expired (data.code: exportExpired) nach Ablauf der 7 Tage