API Gambar Tanda Tangan: Unduh PNG Tanda Tangan

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

Mengembalikan tanda tangan atau inisial yang dibubuhkan penandatangan pada sebuah kolom dalam format PNG. Jalurnya ada di image_url kolom, dalam signatures[].documents[].fields[], jadi Anda tidak perlu menyusunnya sendiri. Endpoint ini memerlukan 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

Tanda tangan yang digambar adalah gambar yang digambar penandatangan, dan gambar itulah yang dicap ke dalam PDF bertanda tangan. Tanda tangan ketikan adalah nama penandatangan yang telah diverifikasi, dengan gaya tulisan tangan yang mereka pilih, dan PDF bertanda tangan menyimpannya sebagai teks dengan gaya yang sama. Untuk bukti tanda tangan itu sendiri, gunakan dokumen bertanda tangan dan bukti. Kolom yang bukan milik penandatangan, atau yang tidak memiliki tanda tangan atau inisial yang dibubuhkan, akan mengembalikan 404 dengan signature_field_not_found. Gambar tersimpan yang tidak lagi cocok dengan SHA-256 yang tercatat akan mengembalikan 400 dengan signature_document_changed. Setelah Anda menghapus sesi, rute ini akan mengembalikan 404.

Terkait

Otorisasi

x-api-key

string

header

wajib

Kunci API aplikasi Anda, dari Developers -> API keys di Business Console. Kunci utama memiliki akses penuh. Kunci bernama dapat diberi cakupan: none, read, atau write per sumber daya, dibatasi pada beberapa alur kerja atau pada sesi yang disetujui, pada daftar alamat IP, dan pada tanggal kedaluwarsa. 401 berarti kuncinya salah, dicabut, atau kedaluwarsa; 403 berarti tidak ada kunci yang dikirimkan, kunci tidak memiliki akses ke sumber daya atau tindakan ini, atau permintaan datang dari alamat di luar daftar IP-nya; 404 pada rute sesi berarti sesi berada di luar alur kerja atau status kunci tersebut. Kunci tanpa akses media menerima URL gambar, video, dan PDF sebagai null, dan kunci tanpa izin tulis sesi menerima tautan sesi dan token sebagai null. Lihat https://docs.didit.me/console/api-keys.

Parameter Path

sessionId

string<uuid>

wajib

Sesi Verifikasi Pengguna (KYC) atau Verifikasi Bisnis (KYB).

Contoh:

"11111111-2222-3333-4444-555555555555"

nodeId

string

wajib

Langkah Tanda Tangan Elektronik: node_id dari item dalam signatures[].

Contoh:

"feature_signature"

fieldId

string<uuid>

wajib

Kolom pada salinan penanda tangan ini, seperti image_url milik kolom tersebut.

Respons

Gambar.

The response is of type file.

Terakhir diubah pada 7 November 2026

​Terkait

Otorisasi

Parameter Path

Respons

Terkait