Bericht-PDF herunterladen

GET /api/organization/report-runs/:id/pdf

Liefert das PDF, das für einen Bericht-Lauf archiviert wurde, direkt im Response-Body. :id ist die id des Laufs (eine UUID), wie sie von Bericht-Läufe auflisten zurückgegeben wird. Der Lauf muss zu Ihrer Organisation gehören. Verfügbar für jede Organisationsrolle, auch für Nur-Lese-Benutzer.

Die Bytes werden serverseitig aus dem Object Storage gelesen und an Sie zurückgegeben; das Objekt selbst wird nie als URL offengelegt, die Sitzungs-/Token-Prüfung bei diesem Aufruf ist damit die gesamte Zugriffskontrolle für die Datei.

Nur erfolgreich abgeschlossene Läufe mit format: "email_pdf" archivieren ein PDF. Prüfen Sie hasPdf beim Lauf, bevor Sie diesen Endpoint aufrufen. Läufe mit format: "email" sowie fehlgeschlagene oder übersprungene Läufe haben kein PDF und liefern 404.

Beispiel (cURL)

BASE_URL="https://uptimeify.io"
TOKEN="<ihr-api-token>"
RUN_ID="9a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d"

curl -X GET "$BASE_URL/api/organization/report-runs/$RUN_ID/pdf" \
  -H "Authorization: Bearer $TOKEN" \
  -o bericht.pdf

Antwort

200 OK mit den PDF-Bytes als Response-Body.

Content-Type: application/pdf, Content-Disposition: attachment; filename="report-<period>.pdf" (<period> wird aus dem Perioden-Label des Laufs abgeleitet, z. B. report-08-2026.pdf), Cache-Control: private, max-age=300, X-Content-Type-Options: nosniff.

Häufige Fehler

• 401 Unauthorized: nicht authentifiziert.
• 403 Forbidden (forbidden): kein Zugriff auf diese Organisation.
• 404 Not Found (reportRunNotFound): es existiert kein Lauf mit dieser ID für Ihre Organisation.
• 404 Not Found (reportRunNoPdf): der Lauf hat kein archiviertes PDF (Nur-E-Mail-Bericht, oder die Erzeugung ist fehlgeschlagen bzw. wurde übersprungen).
• 404 Not Found (reportPdfNotFound): der Lauf-Datensatz hat einen PDF-Pfad, aber das Objekt konnte nicht aus dem Object Storage gelesen werden.