Preuve de signature électronique : API et PDF d'audit

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

Renvoie le PDF de preuves d’un signataire, une fois qu’il a signé. Le chemin figure dans signatures[].evidence_file du signataire, avec signature_id déjà renseigné.

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

Transmettez toujours signature_id. Une étape de Vérification d’entreprise (KYB) peut comporter plusieurs signataires ; sans ce paramètre, la route en sélectionne un parmi eux.

Le PDF de preuves indique le niveau et le format, le signataire, l’adresse IP, chaque document avec son empreinte SHA-256 d’origine, la signature adoptée, la valeur de chaque champ avec sa source et son horodatage, le consentement final et l’empreinte SHA-256 de chaque fichier signé. Pour une signature avancée (AES), il mentionne aussi la session d’identité vérifiée, la confirmation par code, le certificat et l’horodatage ; une signature simple n’en comporte aucun. Voir Le PDF de preuves. Un signataire qui n’a pas signé reçoit une réponse 404 avec signature_not_signed. Après avoir supprimé la session, la route renvoie 404.

Ressources associées

Autorisations

x-api-key

string

header

requis

La clé API de votre application, issue de Développeurs -> Clés API dans la Business Console. La clé principale dispose d'un accès complet. Une clé nommée peut être restreinte : aucun, lecture ou écriture par ressource, limitée à certains workflows ou aux sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou action, ou que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur une route de session signifie que la session est hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL d'images, de vidéos et de PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys.

Paramètres de chemin

sessionId

string<uuid>

requis

La session de vérification des utilisateurs (KYC) ou de vérification d'entreprise (KYB).

Exemple:

"11111111-2222-3333-4444-555555555555"

nodeId

string

requis

L'étape de signature électronique : node_id de l'élément dans signatures[].

Exemple:

"feature_signature"

Paramètres de requête

signature_id

string<uuid>

id de l'élément du signataire dans signatures[].

Réponse

Le PDF des éléments de preuve.

The response is of type file.

Dernière modification le 7 novembre 2026

​Ressources associées

Autorisations

Paramètres de chemin

Paramètres de requête

Réponse

Ressources associées