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

# Scarica un PDF di risultato

> Ottieni un PDF firmato digitalmente che attesta un risultato di rilevamento passato, disponibile per 24 ore.

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

Restituisce un PDF firmato digitalmente che attesta un risultato di rilevamento passato.
Usalo quando ti serve un artefatto condivisibile e verificabile di una verifica: una
traccia di conformità, un allegato a un report o una prova in un esame.

Il PDF è disponibile per **24 ore** dopo la verifica originale. Non contiene dati
personali: nessun indirizzo IP, nessun user agent, nessun nome file e nessuno dei byte
caricati — solo i fatti del verdetto, il `request_id`, una regione approssimativa e il
timestamp.

## Richiesta

`request_id` è l'UUID restituito da
[`POST /v1/public/detect`](/it/content-verification/detect). L'endpoint non accetta
parametri e non richiede autenticazione.

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

<Note>
  La risposta di rilevamento porta anche una `result_pdf_url` già pronta. **Segui quell'URL
  esattamente come viene restituito** invece di comporne uno tu — esso e il percorso qui
  sopra servono lo stesso PDF firmato. `result_pdf_url` è `null` quando la persistenza
  dei risultati non è disponibile; in quel caso non c'è alcun PDF da scaricare.
</Note>

## Risposta

`200 OK` con `Content-Type: application/pdf` e i seguenti header:

| Header                   | Valore                                                          |
| ------------------------ | --------------------------------------------------------------- |
| `Content-Disposition`    | `attachment; filename="samsa-detection-<request_id>.pdf"`       |
| `Cache-Control`          | `private, max-age=<secondi rimanenti nella finestra di 24 ore>` |
| `X-Content-Type-Options` | `nosniff`                                                       |

Il documento ripropone il verdetto, l'esito per ogni tecnica, i metadati del record
(`request_id`, timestamp della risposta, regione approssimativa) e il link di verifica
indipendente.

## Firma

Il PDF porta una firma PKCS#7/CMS staccata in stile PAdES, applicata come aggiornamento
incrementale del PDF — il file resta quindi un PDF ordinario e si apre con qualsiasi
lettore. È firmato con la stessa identità di firma usata dalla via di firma C2PA di
Samsa, quindi l'autenticità è verificabile rispetto alla stessa catena di certificati.
Un byte manomesso o una radice CA sbagliata non superano la verifica.

Se il firmatario non è configurato, l'endpoint restituisce `503` anziché un PDF non
firmato — un risultato non firmato non viene mai servito.

## Errori

Gli errori restituiscono `{"detail": "…"}` — non l'
[envelope degli errori](/it/guides/errors) dell'API REST di Samsa.

| Stato | Quando                                                                                                                                                               |
| ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `404` | Il `request_id` è sconosciuto o non è un UUID.                                                                                                                       |
| `410` | Il risultato è più vecchio della finestra di disponibilità di 24 ore. Il record può permanere per finalità di conservazione, ma il PDF viene emesso solo per 24 ore. |
| `503` | L'archivio dei risultati o il firmatario è temporaneamente non disponibile. La risposta porta un header `Retry-After` — riprova.                                     |

<Tip>
  Scarica il PDF finché è fresco e archivialo dalla tua parte se ti serve oltre le
  24 ore. Una volta chiusa la finestra l'endpoint restituisce `410` e il documento non
  può essere riemesso.
</Tip>