Bericht-PDF herunterladen

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

Leitet (302) auf eine zeitlich begrenzte, signierte Object-Storage-URL für das PDF weiter, das für einen Bericht-Lauf archiviert wurde. :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.

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" \
  -L -o bericht.pdf

Antwort

302 Found mit einem Location-Header, der auf eine signierte, kurzlebige URL für das PDF-Objekt zeigt. Kein Response-Body. Folgen Sie der Weiterleitung (-L bei cURL, oder die Standard-Redirect-Behandlung Ihres HTTP-Clients), um die Datei herunterzuladen.

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).