API de evidências de assinatura: PDF de auditoria

Python

from didit import Didit

# Reads DIDIT_API_KEY.
client = Didit()

content = client.sessions.signatures.download_evidence(
    "11111111-2222-3333-4444-555555555555",
    "feature_signature",
)
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.downloadEvidence(
  "11111111-2222-3333-4444-555555555555",
  "feature_signature",
);
await writeFile("download.pdf", Buffer.from(await content.arrayBuffer()));

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

resp, err := client.Sessions.Signatures.DownloadEvidence(ctx, "11111111-2222-3333-4444-555555555555", "feature_signature", didit.SessionsSignaturesDownloadEvidenceParams{})
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().downloadEvidence("11111111-2222-3333-4444-555555555555", "feature_signature")
        .writeTo(Path.of("download.pdf"));

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

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

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

require "didit"

# Reads DIDIT_API_KEY.
didit = Didit::Client.new

content = didit.sessions.signatures.download_evidence(
  "11111111-2222-3333-4444-555555555555",
  "feature_signature"
)
File.binwrite("download.pdf", content)

using System;
using Didit;

// Reads DIDIT_API_KEY.
using var client = new DiditClient();

var content = await client.Sessions.Signatures.DownloadEvidenceAsync("11111111-2222-3333-4444-555555555555", "feature_signature");
await content.SaveToAsync("download.pdf");

"<string>"

GET

session

{sessionId}

signatures

{nodeId}

evidence

Python

from didit import Didit

# Reads DIDIT_API_KEY.
client = Didit()

content = client.sessions.signatures.download_evidence(
    "11111111-2222-3333-4444-555555555555",
    "feature_signature",
)
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.downloadEvidence(
  "11111111-2222-3333-4444-555555555555",
  "feature_signature",
);
await writeFile("download.pdf", Buffer.from(await content.arrayBuffer()));

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

resp, err := client.Sessions.Signatures.DownloadEvidence(ctx, "11111111-2222-3333-4444-555555555555", "feature_signature", didit.SessionsSignaturesDownloadEvidenceParams{})
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().downloadEvidence("11111111-2222-3333-4444-555555555555", "feature_signature")
        .writeTo(Path.of("download.pdf"));

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

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

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

require "didit"

# Reads DIDIT_API_KEY.
didit = Didit::Client.new

content = didit.sessions.signatures.download_evidence(
  "11111111-2222-3333-4444-555555555555",
  "feature_signature"
)
File.binwrite("download.pdf", content)

using System;
using Didit;

// Reads DIDIT_API_KEY.
using var client = new DiditClient();

var content = await client.Sessions.Signatures.DownloadEvidenceAsync("11111111-2222-3333-4444-555555555555", "feature_signature");
await content.SaveToAsync("download.pdf");

"<string>"

Retorna o PDF de evidências de um signatário, depois que ele assina. O caminho está em signatures[].evidence_file do signatário, com signature_id já definido.

curl -L 'https://verification.didit.me/v3/session/{session_id}/signatures/{node_id}/evidence/?signature_id={signature_id}' \
  -H 'x-api-key: YOUR_API_KEY' \
  -o signature-evidence.pdf

Sempre envie signature_id. Uma etapa de Verificação de empresas pode ter vários signatários e, sem ele, a rota escolhe um deles.

O PDF de evidências registra o nível e o formato, o signatário, o endereço IP, cada documento com seu SHA-256 original, a assinatura adotada, o valor de cada campo com sua origem e horário, o consentimento final e o SHA-256 de cada arquivo assinado. Para uma assinatura Avançada (AES), ele também registra a sessão de verificação de identidade, a confirmação por código, o certificado e o carimbo de tempo; uma assinatura Simples não tem nada disso. Consulte O PDF de evidências. Um signatário que ainda não assinou retorna 404 com signature_not_signed. Depois que você exclui a sessão, a rota retorna 404.

Relacionados

Autorizações

x-api-key

string

header

obrigatório

Chave de API da sua aplicação, em Developers -> API keys no Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter escopo restrito: nenhum acesso, leitura ou escrita por recurso, limitada a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está errada, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que a requisição veio de um endereço fora da sua lista de IPs; 404 em uma rota de sessão significa que a sessão está fora dos fluxos ou status da chave. Uma chave sem acesso a mídia recebe URLs de imagem, vídeo e PDF como null, e uma chave sem permissão de escrita em sessões recebe links e tokens de sessão como null. Consulte https://docs.didit.me/console/api-keys.

Parâmetros de caminho

sessionId

string<uuid>

obrigatório

A sessão de Verificação de usuários (KYC) ou de Verificação de empresas (KYB).

Exemplo:

"11111111-2222-3333-4444-555555555555"

nodeId

string

obrigatório

A etapa de Assinatura eletrônica: node_id do item em signatures[].

Exemplo:

"feature_signature"

Parâmetros de consulta

signature_id

string<uuid>

id do item do signatário em signatures[].

Resposta

O PDF de evidências.

The response is of type file.

Última modificação em 1 de novembro de 2026

​Relacionados

Autorizações

Parâmetros de caminho

Parâmetros de consulta

Resposta

Relacionados