> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# API Gambar Tanda Tangan: Unduh PNG Tanda Tangan

> Unduh tanda tangan atau inisial yang dibubuhkan penandatangan pada kolom dokumen Tanda Tangan Elektronik sebagai PNG dengan Didit.

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`.

```bash theme={null}
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](https://docs.didit.me/id/sessions-api/electronic-signature/download-signed-document.md) dan [bukti](https://docs.didit.me/id/sessions-api/electronic-signature/download-evidence.md).

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](https://docs.didit.me/id/sessions-api/delete-session.md), rute ini akan mengembalikan `404`.

## Terkait

* [Kolom pada dokumen](https://docs.didit.me/id/core-technology/electronic-signature/overview.md#kolom-pada-dokumen)
* [Laporan Tanda Tangan Elektronik](https://docs.didit.me/id/core-technology/electronic-signature/report-electronic-signature.md#kolom)


## OpenAPI

````yaml id/openapi-25.json GET /v3/session/{sessionId}/signatures/{nodeId}/fields/{fieldId}/image/
openapi: 3.0.0
info:
  version: 3.0.0
  title: Didit Verification API
  description: API Verifikasi Identitas. Lakukan autentikasi dengan header x-api-key.
servers:
  - url: https://verification.didit.me
security: []
tags: []
paths:
  /v3/session/{sessionId}/signatures/{nodeId}/fields/{fieldId}/image/:
    get:
      tags:
        - Sessions
      summary: Unduh gambar tanda tangan
      description: >-
        Unduh tanda tangan atau inisial yang dibubuhkan penandatangan pada suatu
        kolom, sebagai PNG. Gunakan `image_url` dari kolom di
        `signatures[].documents[].fields[]`. Memerlukan `read:sessions`; kunci
        API Anda berfungsi.
      operationId: get_v3_session_signature_field_image
      parameters:
        - name: sessionId
          in: path
          required: true
          description: Sesi Verifikasi Pengguna (KYC) atau Verifikasi Bisnis (KYB).
          schema:
            type: string
            format: uuid
            example: 11111111-2222-3333-4444-555555555555
        - name: nodeId
          in: path
          required: true
          description: >-
            Langkah Tanda Tangan Elektronik: `node_id` dari item dalam
            `signatures[]`.
          schema:
            type: string
            example: feature_signature
        - name: fieldId
          in: path
          required: true
          description: >-
            Kolom pada salinan penanda tangan ini, seperti `image_url` milik
            kolom tersebut.
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Gambar.
          content:
            image/png:
              schema:
                type: string
                format: binary
        '400':
          description: Gambar yang disimpan tidak lagi cocok dengan SHA-256 yang tercatat.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                  code:
                    type: string
              example:
                code: signature_document_changed
                detail: signature_document_changed
        '403':
          description: >-
            Kredensial tidak ada, atau kredensial yang tidak dapat membaca sesi
            ini. Kunci yang tidak ada mengembalikan `403`; kunci yang salah,
            dicabut, atau kedaluwarsa mengembalikan `401`.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
              example:
                detail: You do not have permission to perform this action.
        '404':
          description: >-
            Tidak ada gambar yang cocok: sesi, langkah, atau kolom tidak ada,
            telah dihapus, atau tidak memiliki tanda tangan maupun inisial yang
            diterapkan.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                  code:
                    type: string
              examples:
                Unknown field:
                  summary: Tidak ada kolom seperti itu
                  value:
                    code: signature_field_not_found
                    detail: signature_field_not_found
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - lang: python
          label: Python
          source: |-
            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)
        - lang: javascript
          label: Node.js
          source: >-
            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()));
        - lang: go
          label: Go
          source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresp, err := client.Sessions.Signatures.DownloadFieldImage(ctx, \"11111111-2222-3333-4444-555555555555\", \"feature_signature\", \"11111111-2222-3333-4444-555555555555\")\nif err != nil {\n\tlog.Fatal(err)\n}\ndefer resp.Body.Close()\nfile, err := os.Create(\"download.png\")\nif err != nil {\n\tlog.Fatal(err)\n}\ndefer file.Close()\nif _, err := io.Copy(file, resp.Body); err != nil {\n\tlog.Fatal(err)\n}"
        - lang: java
          label: Java
          source: >-
            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"));
        - lang: php
          label: PHP
          source: >-
            <?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');
        - lang: ruby
          label: Ruby
          source: |-
            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)
        - lang: csharp
          label: .NET
          source: >-
            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");
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        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.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.