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

# Télécharger un PDF de résultat

> Récupère un PDF signé numériquement attestant d'un résultat de détection passé, disponible pendant 24 heures.

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

Renvoie un PDF signé numériquement attestant d'un résultat de détection passé.
Utilise-le quand tu as besoin d'un artefact partageable et vérifiable d'une
vérification : une trace de conformité, une pièce jointe à un rapport, ou une preuve
dans un examen.

Le PDF est disponible pendant **24 heures** après la vérification d'origine. Il ne
contient aucune donnée personnelle : ni adresse IP, ni user agent, ni nom de fichier, ni
aucun des octets envoyés — seulement les faits du verdict, le `request_id`, une région
approximative et l'horodatage.

## Requête

`request_id` est l'UUID renvoyé par
[`POST /v1/public/detect`](/fr/content-verification/detect). L'endpoint ne prend aucun
paramètre et n'exige aucune authentification.

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

<Note>
  La réponse de détection porte aussi une `result_pdf_url` prête à l'emploi. **Suis
  cette URL exactement telle qu'elle est renvoyée** plutôt que d'en composer une
  toi-même — elle et le chemin ci-dessus servent le même PDF signé. `result_pdf_url`
  vaut `null` quand la persistance des résultats est indisponible ; dans ce cas il n'y a
  aucun PDF à récupérer.
</Note>

## Réponse

`200 OK` avec `Content-Type: application/pdf` et les en-têtes suivants :

| En-tête                  | Valeur                                                          |
| ------------------------ | --------------------------------------------------------------- |
| `Content-Disposition`    | `attachment; filename="samsa-detection-<request_id>.pdf"`       |
| `Cache-Control`          | `private, max-age=<secondes restantes dans la fenêtre de 24 h>` |
| `X-Content-Type-Options` | `nosniff`                                                       |

Le document reprend le verdict, le résultat par technique, les métadonnées de
l'enregistrement (`request_id`, horodatage de la réponse, région approximative) et le
lien de vérification indépendante.

## Signature

Le PDF porte une signature détachée PKCS#7/CMS de style PAdES, appliquée comme une mise
à jour incrémentale du PDF — le fichier reste donc un PDF ordinaire et s'ouvre dans
n'importe quel lecteur. Il est signé avec la même identité de signature que celle
utilisée par la voie de signature C2PA de Samsa, de sorte que l'authenticité se vérifie
contre la même chaîne de certificats. Un octet altéré ou une racine de CA incorrecte
échoue à la vérification.

Si le signataire n'est pas configuré, l'endpoint renvoie `503` plutôt qu'un PDF non
signé — un résultat non signé n'est jamais servi.

## Erreurs

Les erreurs renvoient `{"detail": "…"}` — et non l'
[enveloppe d'erreur](/fr/guides/errors) de l'API REST Samsa.

| Statut | Quand                                                                                                                                                                               |
| ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `404`  | Le `request_id` est inconnu ou n'est pas un UUID.                                                                                                                                   |
| `410`  | Le résultat est plus ancien que la fenêtre de disponibilité de 24 heures. L'enregistrement peut subsister à des fins de conservation, mais le PDF n'est émis que pendant 24 heures. |
| `503`  | Le stockage des résultats ou le signataire est temporairement indisponible. La réponse porte un en-tête `Retry-After` — réessaie.                                                   |

<Tip>
  Récupère le PDF tant qu'il est frais et archive-le de ton côté si tu en as besoin
  au-delà de 24 heures. Une fois la fenêtre fermée, l'endpoint renvoie `410` et le
  document ne peut pas être réémis.
</Tip>