> ## 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: 전자 서명 필드 PNG 다운로드

> 전자 서명 문서의 필드에 서명자가 남긴 서명 또는 이니셜을 PNG 이미지로 다운로드합니다. Didit API로 제공됩니다.

PNG 형식으로 서명자가 필드에 적용한 서명 또는 이니셜을 반환합니다. 경로는 필드의 `image_url`에 있으며, `signatures[].documents[].fields[]`에서 확인할 수 있으므로 직접 구성할 필요가 없습니다. `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
```

직접 그린 서명은 서명자가 그린 이미지이며, 서명된 PDF에 찍히는 이미지이기도 합니다. 타이핑 서명은 검증된 서명자의 이름을 서명자가 선택한 필기체 스타일로 표시한 것이며, 서명된 PDF에는 같은 스타일의 텍스트로 포함됩니다. 서명 자체에 대한 증빙이 필요하면 [서명된 문서](https://docs.didit.me/ko/sessions-api/electronic-signature/download-signed-document.md)와 [증거 자료](https://docs.didit.me/ko/sessions-api/electronic-signature/download-evidence.md)를 사용합니다.

서명자의 것이 아니거나 적용된 서명 또는 이니셜이 없는 필드는 `404`와 `signature_field_not_found`를 반환합니다. 저장된 이미지가 기록된 SHA-256 값과 더 이상 일치하지 않으면 `400`과 `signature_document_changed`를 반환합니다. [세션을 삭제](https://docs.didit.me/ko/sessions-api/delete-session.md)한 후에는 이 경로가 `404`를 반환합니다.

## 관련 문서

* [문서의 필드](https://docs.didit.me/ko/core-technology/electronic-signature/overview.md#문서의-필드)
* [전자 서명 보고서](https://docs.didit.me/ko/core-technology/electronic-signature/report-electronic-signature.md#필드)


## OpenAPI

````yaml ko/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입니다. x-api-key 헤더로 인증합니다.
servers:
  - url: https://verification.didit.me
security: []
tags: []
paths:
  /v3/session/{sessionId}/signatures/{nodeId}/fields/{fieldId}/image/:
    get:
      tags:
        - Sessions
      summary: 서명 이미지 다운로드
      description: >-
        서명자가 필드에 적용한 서명 또는 이니셜을 PNG로 다운로드합니다.
        `signatures[].documents[].fields[]`에 있는 필드의 `image_url`을 사용하세요.
        `read:sessions` 권한이 필요하며, API 키를 사용할 수 있습니다.
      operationId: get_v3_session_signature_field_image
      parameters:
        - name: sessionId
          in: path
          required: true
          description: 사용자 인증(KYC) 또는 기업 확인(KYB) 세션입니다.
          schema:
            type: string
            format: uuid
            example: 11111111-2222-3333-4444-555555555555
        - name: nodeId
          in: path
          required: true
          description: '전자 서명 단계: `signatures[]` 항목의 `node_id`입니다.'
          schema:
            type: string
            example: feature_signature
        - name: fieldId
          in: path
          required: true
          description: 해당 서명자의 사본에 있는 필드입니다(필드의 `image_url`에 있는 것처럼).
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: 이미지입니다.
          content:
            image/png:
              schema:
                type: string
                format: binary
        '400':
          description: 저장된 이미지가 기록된 SHA-256과 더 이상 일치하지 않습니다.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                  code:
                    type: string
              example:
                code: signature_document_changed
                detail: signature_document_changed
        '403':
          description: >-
            자격 증명이 누락되었거나, 이 세션을 읽을 수 없는 자격 증명입니다. 키가 누락되면 `403`을 반환하고, 잘못되었거나
            취소되었거나 만료된 키는 `401`을 반환합니다.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
              example:
                detail: You do not have permission to perform this action.
        '404':
          description: 일치하는 이미지가 없습니다. 세션, 단계 또는 필드가 존재하지 않거나, 삭제되었거나, 적용된 서명 또는 이니셜이 없습니다.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                  code:
                    type: string
              examples:
                Unknown field:
                  summary: 해당 필드가 없습니다
                  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: >-
        Business Console의 Developers -> API keys에서 발급받은 귀하 애플리케이션의 API 키입니다. 기본
        키는 전체 접근 권한을 갖습니다. 이름이 지정된 키는 리소스별 none, read, write 범위로 권한을 제한할 수 있으며
        특정 워크플로나 승인된 세션, IP 주소 목록, 만료일 등으로 제한할 수도 있습니다. 401은 키가 잘못되었거나 폐기되었거나
        만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스나 작업에 대한 접근 권한이 없거나, 요청이 허용된
        IP 목록 외부 주소에서 발생했음을 의미합니다. 세션 경로에서의 404는 해당 세션이 키의 허용 워크플로 또는 상태 범위를
        벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 비디오, PDF URL을 null로 수신하며, 세션 write
        권한이 없는 키는 세션 링크와 token을 null로 수신합니다.
        https://docs.didit.me/console/api-keys 를 참고하십시오.

````

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