API d'imatge de signatura: PNG de signatura adoptada

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

Retorna, en format PNG, la signatura o les inicials que un signant ha aplicat a un camp. El camí és a image_url del camp, dins de signatures[].documents[].fields[], de manera que no cal construir-lo. Necessita 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

Una signatura dibuixada és la imatge que ha dibuixat el signant, i és la imatge que s’estampa al PDF signat. Una signatura mecanografiada és el nom verificat del signant amb l’estil de lletra manuscrita que ha triat, i el PDF signat la conté com a text amb el mateix estil. Per a la prova de la signatura en si, fes servir el document signat i les evidències. Un camp que no és del signant, o que no hi té cap signatura ni cap inicial aplicada, retorna 404 amb signature_field_not_found. Una imatge emmagatzemada que ja no coincideix amb el seu SHA-256 registrat retorna 400 amb signature_document_changed. Després d’eliminar la sessió, la ruta retorna 404.

Relacionats

Autoritzacions

x-api-key

string

header

requerit

La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys.

Paràmetres de ruta

sessionId

string<uuid>

requerit

La sessió de Verificació d'usuaris (KYC) o Verificació d'empreses (KYB).

Exemple:

"11111111-2222-3333-4444-555555555555"

nodeId

string

requerit

El pas de Signatura electrònica: node_id de l'element a signatures[].

Exemple:

"feature_signature"

fieldId

string<uuid>

requerit

El camp a la còpia d'aquest signant, com ara a l'image_url del camp.

Resposta

La imatge.

The response is of type file.

Darrera modificació el 7 de novembre del 2026

​Relacionats

Autoritzacions

Paràmetres de ruta

Resposta

Relacionats