Lire et restituer les documents

Le CCFN propose plusieurs formes de restitution pour un même UUID. Choisissez l’endpoint selon le besoin de votre application et le format de réponse attendu.

Besoin	Endpoint après `/api/ccfn/v1`	Réponse de succès
Récupérer les octets du fichier	`GET /object/{object}`	Téléchargement binaire
Lire les informations de l’objet	`GET /object/{object}/metadata`	JSON, objet dans `data`
Recevoir un petit fichier dans du JSON	`GET /object/{object}/base64`	JSON, `data.content_base64`
Recevoir le certificat PDF	`GET /object/{object}/certificate`	JSON, `data.certificate_base64`
Exporter les pièces de restitution	`GET /object/{object}/package`	Téléchargement ZIP

Lire le fichier original

curl --fail-with-body --user "$CCFN_USER" \
  -D restitution.headers \
  "$CCFN_BASE_URL/api/ccfn/v1/object/$OBJECT_ID" \
  --output document-restitue.pdf

Le service vérifie l’empreinte du contenu avant sa restitution. Une réponse réussie comporte X-Content-Digest, X-Content-Digest-Algorithm, un ETag et Cache-Control: private, no-store. L’ETag du fichier est basé sur son empreinte ; il ne s’agit pas d’un mécanisme de signature électronique.

Contrôlez le statut HTTP avant de traiter le corps comme un fichier. Une erreur est susceptible de contenir du JSON ou un message d’authentification ; la sauvegarder avec une extension .pdf n’en fait pas un PDF.

Utiliser Base64 à bon escient

La restitution Base64 est limitée à 10 485 760 octets, soit 10 Mio, par défaut. Un fichier plus volumineux retourne 413 sur cet endpoint ; utilisez alors le téléchargement binaire. Cette limite de lecture Base64 est distincte de la limite de 50 Mio au dépôt.

Le certificat est aussi fourni encodé en Base64, à décoder côté client. L’endpoint du certificat ne retourne pas directement un PDF binaire.

Contenu exact du ZIP

Le ZIP contient trois entrées :

Chemin dans le ZIP	Contenu
`object/content`	Octets du document original, sans extension dans ce chemin
`manifest.json`	Description du dépôt et empreintes des éléments de preuve
`proof/deposit-certificate.pdf`	Certificat de dépôt

Le nom et le type d’origine se retrouvent dans le manifeste. Le ZIP est généré à la demande après vérification du contenu et des pièces associées. Il n’est pas conservé comme un nouvel objet de référence. Son empreinte est communiquée dans les en-têtes de téléchargement ; deux générations du ZIP ne sont pas à considérer comme nécessairement identiques octet par octet.

📘
Périmètre de restitution
Le ZIP ne contient pas seal.p7s ni timestamp.tsr. Le manifeste contient leurs empreintes et références. Une vérification cryptographique autonome nécessitant ces artefacts demande leur obtention selon le dispositif de restitution prévu pour votre service ; le ZIP seul ne suffit pas.

Métadonnées et droits

Le droit CCFN_USER_METADATA_READ donne accès aux métadonnées détaillées par UUID, sans donner le droit de télécharger le contenu. La liste retourne aussi des informations d’objet à un compte autorisé à lister. Le droit CCFN_USER_READ couvre les quatre restitutions de contenu : binaire, Base64, certificat et ZIP.

Une désactivation de l’espace bloque les nouveaux dépôts, mais n’empêche pas ces lectures. Après destruction, l’objet ne peut plus être lu avec son UUID.

À lire ensuite : Comprendre les preuves, Contrôle d’intégrité.