API para descargar documento firmado: PDF firmado

Python

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)

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()));

ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()

resp, err := client.Sessions.Signatures.DownloadDocument(ctx, "11111111-2222-3333-4444-555555555555", "feature_signature", "11111111-2222-3333-4444-555555555555")
if err != nil {
	log.Fatal(err)
}
defer resp.Body.Close()
file, err := os.Create("download.pdf")
if err != nil {
	log.Fatal(err)
}
defer file.Close()
if _, err := io.Copy(file, resp.Body); err != nil {
	log.Fatal(err)
}

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"));

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY.
$didit = new DiditClient();

$content = $didit->sessions->signatures->downloadDocument('11111111-2222-3333-4444-555555555555', 'feature_signature', '11111111-2222-3333-4444-555555555555');
$content->saveTo('download.pdf');

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)

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");

"<string>"

GET

session

{sessionId}

signatures

{nodeId}

documents

{documentId}

file

Python

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)

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()));

ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()

resp, err := client.Sessions.Signatures.DownloadDocument(ctx, "11111111-2222-3333-4444-555555555555", "feature_signature", "11111111-2222-3333-4444-555555555555")
if err != nil {
	log.Fatal(err)
}
defer resp.Body.Close()
file, err := os.Create("download.pdf")
if err != nil {
	log.Fatal(err)
}
defer file.Close()
if _, err := io.Copy(file, resp.Body); err != nil {
	log.Fatal(err)
}

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"));

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY.
$didit = new DiditClient();

$content = $didit->sessions->signatures->downloadDocument('11111111-2222-3333-4444-555555555555', 'feature_signature', '11111111-2222-3333-4444-555555555555');
$content->saveTo('download.pdf');

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)

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");

"<string>"

Devuelve el PDF firmado de un documento, una vez que su firmante lo ha firmado. No necesitas construir la URL: cada documento firmado de la decisión incluye su ruta en signatures[].documents[].signed_file.

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

El PDF contiene el documento que se mostró al firmante, con los valores de sus campos estampados, y la página de evidencias (salvo que signature_evidence_page del paso esté desactivado). Un PDF avanzado (AES) incluye además la firma PAdES con su sello de tiempo; un PDF simple no tiene firma digital, sello ni sello de tiempo. Antes de devolverlo, Didit compara el archivo almacenado con sha256_signed y responde 409 con signature_document_changed si no coinciden. Un documento que todavía no está firmado devuelve 404 con signature_not_signed. Después de eliminar la sesión, la ruta devuelve 404.

Relacionado

Informe de firma electrónica: qué contiene el PDF firmado.
Descargar las evidencias de la firma
Validar firmas

Autorizaciones

x-api-key

string

header

requerido

La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys.

Parámetros de ruta

sessionId

string<uuid>

requerido

La sesión de verificación de usuarios (KYC) o de verificación de empresas (KYB).

Ejemplo:

"11111111-2222-3333-4444-555555555555"

nodeId

string

requerido

El paso de Firma electrónica: node_id del elemento en signatures[].

Ejemplo:

"feature_signature"

documentId

string<uuid>

requerido

id del documento en signatures[].documents[].

Respuesta

El PDF firmado.

The response is of type file.

Última modificación el 1 de noviembre de 2026

​Relacionado

Autorizaciones

Parámetros de ruta

Respuesta

Relacionado