> ## 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: 감사 추적 PDF

> Didit의 전자 서명 증거 API로 서명자의 증거 PDF를 다운로드하세요. 문서 해시와 필드 값, 고급(AES) 전자 서명의 신원, 코드, 인증서, 타임스탬프를 포함합니다.

서명자가 서명하면 해당 서명자 한 명의 증거 PDF를 반환합니다. 경로는 서명자의 `signatures[].evidence_file`에 있으며, `signature_id`가 이미 설정되어 있습니다.

```bash theme={null}
curl -L 'https://verification.didit.me/v3/session/{session_id}/signatures/{node_id}/evidence/?signature_id={signature_id}' \
  -H 'x-api-key: YOUR_API_KEY' \
  -o signature-evidence.pdf
```

> [!WARNING]
>
> 항상 `signature_id`를 전달하십시오. 기업 확인(KYB) 단계에는 서명자가 여러 명일 수 있으며, 이 값을 전달하지 않으면 경로가 그중 한 명을 선택합니다.

증거 PDF에는 서명 수준과 형식, 서명자, IP 주소, 원본 SHA-256 값을 포함한 각 문서, 채택된 서명, 각 필드의 값과 출처 및 시각, 최종 동의, 서명된 각 파일의 SHA-256 값이 기록됩니다. 고급(AES) 서명의 경우 검증된 신원 세션, 코드 확인, 인증서, 타임스탬프도 기록되며, 간편 서명에는 이 중 어느 것도 없습니다. 자세한 내용은 [증거 PDF](https://docs.didit.me/ko/core-technology/electronic-signature/report-electronic-signature.md#증빙-pdf)를 참조하십시오.

서명하지 않은 서명자에 대해서는 `signature_not_signed`와 함께 `404`가 반환됩니다. [세션을 삭제](https://docs.didit.me/ko/sessions-api/delete-session.md)한 후에는 이 경로가 `404`를 반환합니다.

## 관련 문서

* [서명된 문서 다운로드](https://docs.didit.me/ko/sessions-api/electronic-signature/download-signed-document.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}/evidence/
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}/evidence/:
    get:
      tags:
        - Sessions
      summary: 서명 증거 다운로드
      description: >-
        서명자의 증거 PDF를 다운로드합니다: 서명 수준 및 형식, 서명자, IP 주소, 각 문서와 해당 원본 SHA-256 및 필드
        값, 모든 서명된 파일의 SHA-256과 함께, 고급(AES) 서명의 경우 확인된 신원 세션, 코드 확인, 인증서 및 타임스탬프가
        포함됩니다. `signatures[]`에 있는 서명자 항목의 `evidence_file` 경로를 사용하세요.


        기업 확인(KYB) 단계에 여러 서명자가 있는 경우 항상 `signature_id`를 전달하세요. 전달하지 않으면 라우트가 해당
        단계의 서명자 중 하나를 선택합니다. `read:sessions` 권한이 필요하며, API 키를 사용할 수 있습니다.
      operationId: get_v3_session_signature_evidence
      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: signature_id
          in: query
          required: false
          description: '`signatures[]` 내 서명자 항목의 `id`입니다.'
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: 증거 PDF입니다.
          headers:
            Content-Disposition:
              description: 파일 이름이 포함된 첨부 파일입니다.
              schema:
                type: string
                example: attachment; filename="signature-evidence.pdf"
          content:
            application/pdf:
              schema:
                type: string
                format: binary
        '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:
                Not signed yet:
                  summary: 서명자가 서명하지 않았습니다
                  value:
                    code: signature_not_signed
                    detail: signature_not_signed
                Unknown signer:
                  summary: 이 단계에 해당 서명이 없습니다
                  value:
                    code: signature_not_found
                    detail: signature_not_found
        '409':
          description: 저장된 파일이 기록된 SHA-256과 더 이상 일치하지 않습니다. 아무것도 반환되지 않습니다.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                  code:
                    type: string
              examples:
                Changed file:
                  summary: 저장된 파일이 해시와 일치하지 않습니다
                  value:
                    code: signature_document_changed
                    detail: signature_document_changed
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - lang: python
          label: Python
          source: |-
            from didit import Didit

            # Reads DIDIT_API_KEY.
            client = Didit()

            content = client.sessions.signatures.download_evidence(
                "11111111-2222-3333-4444-555555555555",
                "feature_signature",
            )
            with open("download.pdf", "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.downloadEvidence(
              "11111111-2222-3333-4444-555555555555",
              "feature_signature",
            );

            await writeFile("download.pdf", 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.DownloadEvidence(ctx, \"11111111-2222-3333-4444-555555555555\", \"feature_signature\", didit.SessionsSignaturesDownloadEvidenceParams{})\nif err != nil {\n\tlog.Fatal(err)\n}\ndefer resp.Body.Close()\nfile, err := os.Create(\"download.pdf\")\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().downloadEvidence("11111111-2222-3333-4444-555555555555",
            "feature_signature")
                    .writeTo(Path.of("download.pdf"));
        - lang: php
          label: PHP
          source: >-
            <?php


            require 'vendor/autoload.php';


            use Didit\DiditClient;


            // Reads DIDIT_API_KEY.

            $didit = new DiditClient();


            $content =
            $didit->sessions->signatures->downloadEvidence('11111111-2222-3333-4444-555555555555',
            'feature_signature');

            $content->saveTo('download.pdf');
        - lang: ruby
          label: Ruby
          source: |-
            require "didit"

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

            content = didit.sessions.signatures.download_evidence(
              "11111111-2222-3333-4444-555555555555",
              "feature_signature"
            )
            File.binwrite("download.pdf", 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.DownloadEvidenceAsync("11111111-2222-3333-4444-555555555555",
            "feature_signature");

            await content.SaveToAsync("download.pdf");
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.