> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Scarica documento firmato API: PDF firmato > Scarica il PDF firmato di un documento di un passaggio di firma elettronica per una sessione KYC o KYB con la chiave API di Didit. Restituisce il PDF firmato di un documento, una volta che il firmatario lo ha firmato. Non è necessario costruire l'URL: ogni documento firmato nella decisione riporta il suo percorso in `signatures[].documents[].signed_file`. ```bash theme={null} curl -L 'https://verification.didit.me/v3/session/{session_id}/signatures/{node_id}/documents/{document_id}/file/' \ -H 'x-api-key: YOUR_API_KEY' \ -o agreement-signed.pdf ``` Il PDF contiene il documento mostrato al firmatario con i valori dei campi apposti, e la pagina delle evidenze (a meno che `signature_evidence_page` del passaggio non sia disattivato). Un PDF Advanced (AES) include anche la firma PAdES con il relativo timestamp; un PDF Simple non ha firma digitale, sigillo né timestamp. Prima di restituirlo, Didit verifica il file memorizzato rispetto a `sha256_signed` e, se i due valori non corrispondono, risponde con `409` e `signature_document_changed`. Un documento non ancora firmato restituisce `404` con `signature_not_signed`. Dopo che hai [eliminato la sessione](https://docs.didit.me/it/sessions-api/delete-session.md), l'endpoint restituisce `404`. ## Contenuti correlati * [Report della firma elettronica](https://docs.didit.me/it/core-technology/electronic-signature/report-electronic-signature.md#il-pdf-firmato): cosa contiene il PDF firmato. * [Scarica le prove della firma](https://docs.didit.me/it/sessions-api/electronic-signature/download-evidence.md) * [Convalida delle firme](https://docs.didit.me/it/sessions-api/electronic-signature/validate-signatures.md) ## OpenAPI ````yaml it/openapi-25.json GET /v3/session/{sessionId}/signatures/{nodeId}/documents/{documentId}/file/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API di verifica dell'identità. Autenticati con l'intestazione x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/session/{sessionId}/signatures/{nodeId}/documents/{documentId}/file/: get: tags: - Sessions summary: Scarica un documento firmato description: >- Scarica il PDF firmato di un documento di un passaggio di Firma elettronica. Usa il percorso `signed_file` di `signatures[].documents[]` nella decisione. Il PDF contiene il documento mostrato al firmatario con i valori dei relativi campi stampati e la pagina di prova (a meno che `signature_evidence_page` non sia disattivato). Un PDF Avanzato (AES) include anche la firma PAdES con la relativa marca temporale; un PDF Semplice non ha firma digitale, sigillo o marca temporale. Didit verifica il file confrontandolo con `sha256_signed` prima di restituirlo. Funziona per sessioni di Verifica degli utenti (KYC) e Verifica aziendale (KYB). Richiede `read:sessions`; la tua chiave API funziona. Consulta il [report della Firma elettronica](/it/core-technology/electronic-signature/report-electronic-signature#scarica-i-documenti-firmati). operationId: get_v3_session_signature_document_file parameters: - name: sessionId in: path required: true description: >- La sessione di Verifica degli utenti (KYC) o Verifica aziendale (KYB). schema: type: string format: uuid example: 11111111-2222-3333-4444-555555555555 - name: nodeId in: path required: true description: >- Il passaggio di Firma elettronica: `node_id` dell'elemento in `signatures[]`. schema: type: string example: feature_signature - name: documentId in: path required: true description: '`id` del documento in `signatures[].documents[]`.' schema: type: string format: uuid responses: '200': description: Il PDF firmato. headers: Content-Disposition: description: Allegato con il nome del file. schema: type: string example: attachment; filename="agreement-signed.pdf" content: application/pdf: schema: type: string format: binary '403': description: >- Credenziali mancanti o credenziale che non può leggere questa sessione. L'assenza della chiave restituisce `403`; una chiave errata, revocata o scaduta restituisce `401`. content: application/json: schema: type: object properties: detail: type: string example: detail: You do not have permission to perform this action. '404': description: >- Nessun documento firmato corrispondente: la sessione, il passaggio o il documento non esiste, è stato eliminato o non è ancora stato firmato. content: application/json: schema: type: object properties: detail: type: string code: type: string examples: Not signed yet: summary: Il firmatario non ha firmato value: code: signature_not_signed detail: signature_not_signed Unknown document: summary: Nessun documento del genere in questo passaggio value: code: signature_not_found detail: signature_not_found '409': description: >- Il file salvato non corrisponde più al suo SHA-256 registrato. Non viene restituito nulla. content: application/json: schema: type: object properties: detail: type: string code: type: string examples: Changed file: summary: Il file archiviato non corrisponde al relativo hash value: code: signature_document_changed detail: signature_document_changed security: - ApiKeyAuth: [] x-codeSamples: - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() content = client.sessions.signatures.download_document( "11111111-2222-3333-4444-555555555555", "feature_signature", "11111111-2222-3333-4444-555555555555", ) with open("download.pdf", "wb") as file: file.write(content) - lang: javascript label: Node.js source: >- import { writeFile } from "node:fs/promises"; import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const content = await didit.sessions.signatures.downloadDocument( "11111111-2222-3333-4444-555555555555", "feature_signature", "11111111-2222-3333-4444-555555555555", ); await writeFile("download.pdf", Buffer.from(await content.arrayBuffer())); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresp, err := client.Sessions.Signatures.DownloadDocument(ctx, \"11111111-2222-3333-4444-555555555555\", \"feature_signature\", \"11111111-2222-3333-4444-555555555555\")\nif err != nil {\n\tlog.Fatal(err)\n}\ndefer resp.Body.Close()\nfile, err := os.Create(\"download.pdf\")\nif err != nil {\n\tlog.Fatal(err)\n}\ndefer file.Close()\nif _, err := io.Copy(file, resp.Body); err != nil {\n\tlog.Fatal(err)\n}" - lang: java label: Java source: >- import java.nio.file.Path; import me.didit.Didit; // Reads DIDIT_API_KEY. Didit client = new Didit(); client.sessions().signatures().downloadDocument("11111111-2222-3333-4444-555555555555", "feature_signature", "11111111-2222-3333-4444-555555555555") .writeTo(Path.of("download.pdf")); - lang: php label: PHP source: >- sessions->signatures->downloadDocument('11111111-2222-3333-4444-555555555555', 'feature_signature', '11111111-2222-3333-4444-555555555555'); $content->saveTo('download.pdf'); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new content = didit.sessions.signatures.download_document( "11111111-2222-3333-4444-555555555555", "feature_signature", "11111111-2222-3333-4444-555555555555" ) File.binwrite("download.pdf", content) - lang: csharp label: .NET source: >- using System; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var content = await client.Sessions.Signatures.DownloadDocumentAsync("11111111-2222-3333-4444-555555555555", "feature_signature", "11111111-2222-3333-4444-555555555555"); await content.SaveToAsync("download.pdf"); components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.