API d'image de signature : PNG de la signature apposée

Python

from didit import Didit

# Reads DIDIT_API_KEY.
client = Didit()

content = client.sessions.signatures.download_field_image(
    "11111111-2222-3333-4444-555555555555",
    "feature_signature",
    "11111111-2222-3333-4444-555555555555",
)
with open("download.png", "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.downloadFieldImage(
  "11111111-2222-3333-4444-555555555555",
  "feature_signature",
  "11111111-2222-3333-4444-555555555555",
);
await writeFile("download.png", Buffer.from(await content.arrayBuffer()));

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

resp, err := client.Sessions.Signatures.DownloadFieldImage(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.png")
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().downloadFieldImage("11111111-2222-3333-4444-555555555555", "feature_signature", "11111111-2222-3333-4444-555555555555")
        .writeTo(Path.of("download.png"));

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

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

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

require "didit"

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

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

using System;
using Didit;

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

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

"<string>"

{
  "code": "signature_document_changed",
  "detail": "signature_document_changed"
}

{
  "detail": "You do not have permission to perform this action."
}

{
  "code": "signature_field_not_found",
  "detail": "signature_field_not_found"
}

GET

session

{sessionId}

signatures

{nodeId}

fields

{fieldId}

image

Python

from didit import Didit

# Reads DIDIT_API_KEY.
client = Didit()

content = client.sessions.signatures.download_field_image(
    "11111111-2222-3333-4444-555555555555",
    "feature_signature",
    "11111111-2222-3333-4444-555555555555",
)
with open("download.png", "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.downloadFieldImage(
  "11111111-2222-3333-4444-555555555555",
  "feature_signature",
  "11111111-2222-3333-4444-555555555555",
);
await writeFile("download.png", Buffer.from(await content.arrayBuffer()));

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

resp, err := client.Sessions.Signatures.DownloadFieldImage(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.png")
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().downloadFieldImage("11111111-2222-3333-4444-555555555555", "feature_signature", "11111111-2222-3333-4444-555555555555")
        .writeTo(Path.of("download.png"));

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

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

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

require "didit"

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

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

using System;
using Didit;

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

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

"<string>"

{
  "code": "signature_document_changed",
  "detail": "signature_document_changed"
}

{
  "detail": "You do not have permission to perform this action."
}

{
  "code": "signature_field_not_found",
  "detail": "signature_field_not_found"
}

Renvoie, au format PNG, la signature ou les paraphes qu’un signataire a apposés sur un champ. Le chemin figure dans le champ image_url de signatures[].documents[].fields[], vous n’avez donc pas à le construire. Cette requête nécessite read:sessions.

curl -L 'https://verification.didit.me/v3/session/{session_id}/signatures/{node_id}/fields/{field_id}/image/' \
  -H 'x-api-key: YOUR_API_KEY' \
  -o signature.png

Une signature dessinée est l’image tracée par le signataire, et c’est cette image qui est apposée dans le PDF signé. Une signature saisie est le nom vérifié du signataire, dans le style d’écriture qu’il a choisi ; le PDF signé la reproduit sous forme de texte dans ce même style. Pour une preuve de la signature elle-même, utilisez le document signé et les preuves. Un champ qui n’appartient pas au signataire, ou sur lequel aucune signature ni aucun paraphe n’a été apposé, renvoie 404 avec signature_field_not_found. Une image stockée qui ne correspond plus à son empreinte SHA-256 enregistrée renvoie 400 avec signature_document_changed. Après que vous avez supprimé la session, la route renvoie 404.

Voir aussi

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"

fieldId

string<uuid>

requis

Le champ sur l'exemplaire destiné à ce signataire, comme dans l'image_url du champ.

Réponse

L'image.

The response is of type file.

Dernière modification le 7 novembre 2026

​Voir aussi

Autorisations

Paramètres de chemin

Réponse

Voir aussi