> ## Documentation Index
> Fetch the complete documentation index at: https://docs.samsa.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Ergebnis-PDF herunterladen

> Rufe eine digital signierte PDF eines früheren Erkennungsergebnisses ab — 24 Stunden lang verfügbar.

```
GET https://detect.samsa.ai/v1/public/detect/result/{request_id}
```

Liefert eine digital signierte PDF eines früheren Erkennungsergebnisses. Nutze sie,
wenn du einen teilbaren, überprüfbaren Nachweis einer Prüfung brauchst — als
Compliance-Nachweis, als Anhang zu einem Bericht oder als Beleg in einer Prüfung.

Die PDF ist **24 Stunden** nach der ursprünglichen Prüfung verfügbar. Sie enthält keine
personenbezogenen Daten: keine IP-Adresse, keinen User-Agent, keinen Dateinamen und
keine der hochgeladenen Bytes — nur die Fakten zum Ergebnis, die `request_id`, eine
grobe Region und den Zeitstempel.

## Request

`request_id` ist die UUID, die
[`POST /v1/public/detect`](/de/content-verification/detect) zurückgibt. Der Endpoint
nimmt keine Parameter entgegen und verlangt keine Authentifizierung.

```bash curl theme={null}
curl -o result.pdf \
  https://detect.samsa.ai/v1/public/detect/result/c1a2b3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d
```

<Note>
  Die Detect-Antwort enthält auch eine fertige `result_pdf_url`. **Folge dieser URL
  genau so, wie sie zurückgegeben wurde**, statt selbst eine zusammenzusetzen — sie und
  der Pfad oben liefern dieselbe signierte PDF. `result_pdf_url` ist `null`, wenn die
  Ergebnis-Persistenz nicht verfügbar ist; dann gibt es keine PDF zum Abrufen.
</Note>

## Response

`200 OK` mit `Content-Type: application/pdf` und den folgenden Headern:

| Header                   | Wert                                                             |
| ------------------------ | ---------------------------------------------------------------- |
| `Content-Disposition`    | `attachment; filename="samsa-detection-<request_id>.pdf"`        |
| `Cache-Control`          | `private, max-age=<verbleibende Sekunden im 24-Stunden-Fenster>` |
| `X-Content-Type-Options` | `nosniff`                                                        |

Das Dokument wiederholt das Urteil, das Ergebnis je Technik, die Metadaten des Eintrags
(`request_id`, Antwort-Zeitstempel, grobe Region) und den unabhängigen Prüf-Link.

## Signatur

Die PDF trägt eine PAdES-artige, abgetrennte PKCS#7/CMS-Signatur, angewandt als
inkrementelles PDF-Update — die Datei bleibt also als gewöhnliche PDF lesbar und lässt
sich mit jedem PDF-Reader öffnen. Sie wird mit derselben Signatur-Identität signiert,
die Samsas C2PA-Signaturweg verwendet, sodass die Echtheit gegen dieselbe
Zertifikatskette überprüfbar ist. Ein manipuliertes Byte oder eine falsche CA-Wurzel
besteht die Prüfung nicht.

Ist der Signierer nicht konfiguriert, liefert der Endpoint `503` statt einer
unsignierten PDF — ein unsigniertes Ergebnis wird nie ausgeliefert.

## Fehler

Fehler kommen als `{"detail": "…"}` zurück — nicht als
[Error-Envelope](/de/guides/errors) der Samsa-REST-API.

| Status | Wann                                                                                                                                                             |
| ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `404`  | Die `request_id` ist unbekannt oder keine UUID.                                                                                                                  |
| `410`  | Das Ergebnis ist älter als das 24-Stunden-Fenster. Der Eintrag kann zu Aufbewahrungszwecken bestehen bleiben, die PDF wird aber nur 24 Stunden lang ausgestellt. |
| `503`  | Der Ergebnisspeicher oder der Signierer ist vorübergehend nicht verfügbar. Die Antwort trägt einen `Retry-After`-Header — wiederhole die Anfrage.                |

<Tip>
  Rufe die PDF ab, solange sie frisch ist, und archiviere sie bei dir, wenn du sie über
  24 Stunden hinaus brauchst. Sobald das Fenster geschlossen ist, liefert der Endpoint
  `410`, und das Dokument kann nicht neu ausgestellt werden.
</Tip>