E-Signatur-Nachweis-API: Audit-Trail-PDF

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

Gibt das Nachweis-PDF eines Unterzeichners zurück, nachdem dieser unterschrieben hat. Der Pfad steht in signatures[].evidence_file des Unterzeichners, wobei signature_id bereits gesetzt ist.

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

Übergeben Sie immer signature_id. Ein Schritt zur Unternehmensverifizierung (KYB) kann mehrere Unterzeichner haben. Ohne diesen Parameter wählt die Route einen davon aus.

Das Nachweis-PDF enthält Stufe und Format, den Unterzeichner, die IP-Adresse, jedes Dokument mit seinem ursprünglichen SHA-256-Wert, die angenommene Signatur, den Wert jedes Feldes mit seiner Quelle und Zeit, die abschließende Einwilligung sowie den SHA-256-Wert jeder signierten Datei. Bei einer Advanced-Signatur (AES) enthält es zusätzlich die verifizierte Identitätssitzung, die Codebestätigung, das Zertifikat und den Zeitstempel. Eine einfache Signatur enthält keines dieser Elemente. Siehe Das Nachweis-PDF. Ein Unterzeichner, der noch nicht unterschrieben hat, erhält 404 mit signature_not_signed. Nachdem Sie die Sitzung gelöscht haben, gibt die Route 404 zurück.

Verwandte Themen

Autorisierungen

x-api-key

string

header

erforderlich

Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys.

Pfadparameter

sessionId

string<uuid>

erforderlich

Die Sitzung zur Benutzerverifizierung (KYC) oder Unternehmensverifizierung (KYB).

Beispiel:

"11111111-2222-3333-4444-555555555555"

nodeId

string

erforderlich

Der E-Signatur-Schritt: node_id des Elements in signatures[].

Beispiel:

"feature_signature"

Abfrageparameter

signature_id

string<uuid>

id des Eintrags des Unterzeichners in signatures[].

Antwort

Das Nachweis-PDF.

The response is of type file.

Zuletzt geändert am 7. November 2026

​Verwandte Themen

Autorisierungen

Pfadparameter

Abfrageparameter

Antwort

Verwandte Themen