from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.document_ai.analyze(
document=open("document.pdf", "rb"),
fields="[{\"key\": \"employer_name\", \"name\": \"Employer name\", \"instruction\": \"The employer or company issuing the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": false}, {\"key\": \"employee_name\", \"name\": \"Employee name\", \"instruction\": \"The full name of the employee as printed on the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": true}, {\"key\": \"net_pay\", \"name\": \"Net pay\", \"instruction\": \"The net amount paid to the employee for the period.\", \"type\": \"number\", \"required\": true, \"is_full_name\": false}, {\"key\": \"pay_date\", \"name\": \"Pay date\", \"instruction\": \"The payment date shown on the payslip.\", \"type\": \"date\", \"required\": false, \"is_full_name\": false}]",
)
print(result)
import Didit, { fileFromPath } from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.documentAi.analyze({
document: await fileFromPath("document.pdf"),
fields: "[{\"key\": \"employer_name\", \"name\": \"Employer name\", \"instruction\": \"The employer or company issuing the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": false}, {\"key\": \"employee_name\", \"name\": \"Employee name\", \"instruction\": \"The full name of the employee as printed on the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": true}, {\"key\": \"net_pay\", \"name\": \"Net pay\", \"instruction\": \"The net amount paid to the employee for the period.\", \"type\": \"number\", \"required\": true, \"is_full_name\": false}, {\"key\": \"pay_date\", \"name\": \"Pay date\", \"instruction\": \"The payment date shown on the payslip.\", \"type\": \"date\", \"required\": false, \"is_full_name\": false}]",
});
console.log(result);
ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.DocumentAi.Analyze(ctx, didit.DocumentAiAnalyzeParams{
Document: didit.FileFromPath("document.pdf"),
Fields: "[{\"key\": \"employer_name\", \"name\": \"Employer name\", \"instruction\": \"The employer or company issuing the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": false}, {\"key\": \"employee_name\", \"name\": \"Employee name\", \"instruction\": \"The full name of the employee as printed on the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": true}, {\"key\": \"net_pay\", \"name\": \"Net pay\", \"instruction\": \"The net amount paid to the employee for the period.\", \"type\": \"number\", \"required\": true, \"is_full_name\": false}, {\"key\": \"pay_date\", \"name\": \"Pay date\", \"instruction\": \"The payment date shown on the payslip.\", \"type\": \"date\", \"required\": false, \"is_full_name\": false}]",
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)
import java.nio.file.Path;
import me.didit.Didit;
import me.didit.types.DocumentAiAnalyzeParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.documentAi().analyze(DocumentAiAnalyzeParams.builder()
.document(Path.of("document.pdf"))
.fields("[{\"key\": \"employer_name\", \"name\": \"Employer name\", \"instruction\": \"The employer or company issuing the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": false}, {\"key\": \"employee_name\", \"name\": \"Employee name\", \"instruction\": \"The full name of the employee as printed on the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": true}, {\"key\": \"net_pay\", \"name\": \"Net pay\", \"instruction\": \"The net amount paid to the employee for the period.\", \"type\": \"number\", \"required\": true, \"is_full_name\": false}, {\"key\": \"pay_date\", \"name\": \"Pay date\", \"instruction\": \"The payment date shown on the payslip.\", \"type\": \"date\", \"required\": false, \"is_full_name\": false}]")
.build());
System.out.println(result);
<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
use Didit\File;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->documentAi->analyze([
'document' => File::fromPath('document.pdf'),
'fields' => '[{"key": "employer_name", "name": "Employer name", "instruction": "The employer or company issuing the payslip.", "type": "text", "required": true, "is_full_name": false}, {"key": "employee_name", "name": "Employee name", "instruction": "The full name of the employee as printed on the payslip.", "type": "text", "required": true, "is_full_name": true}, {"key": "net_pay", "name": "Net pay", "instruction": "The net amount paid to the employee for the period.", "type": "number", "required": true, "is_full_name": false}, {"key": "pay_date", "name": "Pay date", "instruction": "The payment date shown on the payslip.", "type": "date", "required": false, "is_full_name": false}]',
]);
print_r($result->toArray());
require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.document_ai.analyze(
document: Pathname("document.pdf"),
fields: "[{\"key\": \"employer_name\", \"name\": \"Employer name\", \"instruction\": \"The employer or company issuing the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": false}, {\"key\": \"employee_name\", \"name\": \"Employee name\", \"instruction\": \"The full name of the employee as printed on the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": true}, {\"key\": \"net_pay\", \"name\": \"Net pay\", \"instruction\": \"The net amount paid to the employee for the period.\", \"type\": \"number\", \"required\": true, \"is_full_name\": false}, {\"key\": \"pay_date\", \"name\": \"Pay date\", \"instruction\": \"The payment date shown on the payslip.\", \"type\": \"date\", \"required\": false, \"is_full_name\": false}]"
)
puts result.to_h
using System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.DocumentAi.AnalyzeAsync(new DocumentAiAnalyzeParams
{
Document = FileUpload.FromPath("document.pdf"),
Fields = "[{\"key\": \"employer_name\", \"name\": \"Employer name\", \"instruction\": \"The employer or company issuing the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": false}, {\"key\": \"employee_name\", \"name\": \"Employee name\", \"instruction\": \"The full name of the employee as printed on the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": true}, {\"key\": \"net_pay\", \"name\": \"Net pay\", \"instruction\": \"The net amount paid to the employee for the period.\", \"type\": \"number\", \"required\": true, \"is_full_name\": false}, {\"key\": \"pay_date\", \"name\": \"Pay date\", \"instruction\": \"The payment date shown on the payslip.\", \"type\": \"date\", \"required\": false, \"is_full_name\": false}]",
});
Console.WriteLine(JsonSerializer.Serialize(result));
curl --request POST \
--url https://verification.didit.me/v3/document-ai/ \
--header 'Content-Type: multipart/form-data' \
--header 'x-api-key: <api-key>' \
--form document=@example-file \
--form 'fields=[{"key": "employer_name", "name": "Employer name", "instruction": "The employer or company issuing the payslip.", "type": "text", "required": true, "is_full_name": false}, {"key": "employee_name", "name": "Employee name", "instruction": "The full name of the employee as printed on the payslip.", "type": "text", "required": true, "is_full_name": true}, {"key": "net_pay", "name": "Net pay", "instruction": "The net amount paid to the employee for the period.", "type": "number", "required": true, "is_full_name": false}, {"key": "pay_date", "name": "Pay date", "instruction": "The payment date shown on the payslip.", "type": "date", "required": false, "is_full_name": false}]' \
--form expected_first_name=Sophia \
--form expected_last_name=Martinez \
--form 'expected_company_name=<string>' \
--form 'expected_company_country=<string>' \
--form document_ai_name_match_score_threshold=80 \
--form document_ai_unreadable_document_action=REVIEW \
--form document_ai_missing_required_fields_action=REVIEW \
--form document_ai_document_tampering_action=DECLINE \
--form document_ai_name_mismatch_action=NO_ACTION \
--form document_ai_unsupported_file_action=REVIEW \
--form save_api_request=true \
--form vendor_data=user-123 \
--form 'metadata={
"flow": "onboarding"
}'
{ "request_id": "9d6a3b1e-2f0c-4a8e-9b7d-1c2e3f4a5b6c", "document_ai": { "status": "Approved", "extracted_data": { "employer_name": "Acme Payments Ltd", "employee_name": "Sophia Martinez", "net_pay": 3120.5, "pay_date": "2026-07-31" }, "detected_codes": [ { "type": "CODE_128", "page_number": 1, "position": [ [ 96, 456 ], [ 96, 616 ], [ 1012, 611 ], [ 1015, 456 ] ], "x": 96, "y": 456, "width": 919, "height": 160, "page_width": 1200, "page_height": 1700, "raw_payload": "SU5WLTIwMjYtMDA0Mg==", "parsed_payload": "INV-2026-0042" } ], "fields": [ { "key": "employer_name", "name": "Employer name", "instruction": "The employer or company issuing the payslip.", "type": "text", "required": true, "is_full_name": false }, { "key": "employee_name", "name": "Employee name", "instruction": "The full name of the employee as printed on the payslip.", "type": "text", "required": true, "is_full_name": true }, { "key": "net_pay", "name": "Net pay", "instruction": "The net amount paid to the employee for the period.", "type": "number", "required": true, "is_full_name": false }, { "key": "pay_date", "name": "Pay date", "instruction": "The payment date shown on the payslip.", "type": "date", "required": false, "is_full_name": false } ], "name_match_score": 100, "name_on_document": "Sophia Martinez", "warnings": [] }, "vendor_data": "user-123", "metadata": { "flow": "onboarding" }, "created_at": "2026-08-19T16:40:12.318Z"}
문서 AI
문서 AI API: 맞춤형 문서 데이터 추출
POST /v3/document-ai/로 PDF나 이미지에서 정의한 필드를 서버 간 방식으로 추출하며, 이름 대조와 위변조 검사를 지원합니다. Didit 기준 문서당 $0.20.
POST
/
v3
/
document-ai
/
Python
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.document_ai.analyze(
document=open("document.pdf", "rb"),
fields="[{\"key\": \"employer_name\", \"name\": \"Employer name\", \"instruction\": \"The employer or company issuing the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": false}, {\"key\": \"employee_name\", \"name\": \"Employee name\", \"instruction\": \"The full name of the employee as printed on the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": true}, {\"key\": \"net_pay\", \"name\": \"Net pay\", \"instruction\": \"The net amount paid to the employee for the period.\", \"type\": \"number\", \"required\": true, \"is_full_name\": false}, {\"key\": \"pay_date\", \"name\": \"Pay date\", \"instruction\": \"The payment date shown on the payslip.\", \"type\": \"date\", \"required\": false, \"is_full_name\": false}]",
)
print(result)
import Didit, { fileFromPath } from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.documentAi.analyze({
document: await fileFromPath("document.pdf"),
fields: "[{\"key\": \"employer_name\", \"name\": \"Employer name\", \"instruction\": \"The employer or company issuing the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": false}, {\"key\": \"employee_name\", \"name\": \"Employee name\", \"instruction\": \"The full name of the employee as printed on the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": true}, {\"key\": \"net_pay\", \"name\": \"Net pay\", \"instruction\": \"The net amount paid to the employee for the period.\", \"type\": \"number\", \"required\": true, \"is_full_name\": false}, {\"key\": \"pay_date\", \"name\": \"Pay date\", \"instruction\": \"The payment date shown on the payslip.\", \"type\": \"date\", \"required\": false, \"is_full_name\": false}]",
});
console.log(result);
ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.DocumentAi.Analyze(ctx, didit.DocumentAiAnalyzeParams{
Document: didit.FileFromPath("document.pdf"),
Fields: "[{\"key\": \"employer_name\", \"name\": \"Employer name\", \"instruction\": \"The employer or company issuing the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": false}, {\"key\": \"employee_name\", \"name\": \"Employee name\", \"instruction\": \"The full name of the employee as printed on the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": true}, {\"key\": \"net_pay\", \"name\": \"Net pay\", \"instruction\": \"The net amount paid to the employee for the period.\", \"type\": \"number\", \"required\": true, \"is_full_name\": false}, {\"key\": \"pay_date\", \"name\": \"Pay date\", \"instruction\": \"The payment date shown on the payslip.\", \"type\": \"date\", \"required\": false, \"is_full_name\": false}]",
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)
import java.nio.file.Path;
import me.didit.Didit;
import me.didit.types.DocumentAiAnalyzeParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.documentAi().analyze(DocumentAiAnalyzeParams.builder()
.document(Path.of("document.pdf"))
.fields("[{\"key\": \"employer_name\", \"name\": \"Employer name\", \"instruction\": \"The employer or company issuing the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": false}, {\"key\": \"employee_name\", \"name\": \"Employee name\", \"instruction\": \"The full name of the employee as printed on the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": true}, {\"key\": \"net_pay\", \"name\": \"Net pay\", \"instruction\": \"The net amount paid to the employee for the period.\", \"type\": \"number\", \"required\": true, \"is_full_name\": false}, {\"key\": \"pay_date\", \"name\": \"Pay date\", \"instruction\": \"The payment date shown on the payslip.\", \"type\": \"date\", \"required\": false, \"is_full_name\": false}]")
.build());
System.out.println(result);
<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
use Didit\File;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->documentAi->analyze([
'document' => File::fromPath('document.pdf'),
'fields' => '[{"key": "employer_name", "name": "Employer name", "instruction": "The employer or company issuing the payslip.", "type": "text", "required": true, "is_full_name": false}, {"key": "employee_name", "name": "Employee name", "instruction": "The full name of the employee as printed on the payslip.", "type": "text", "required": true, "is_full_name": true}, {"key": "net_pay", "name": "Net pay", "instruction": "The net amount paid to the employee for the period.", "type": "number", "required": true, "is_full_name": false}, {"key": "pay_date", "name": "Pay date", "instruction": "The payment date shown on the payslip.", "type": "date", "required": false, "is_full_name": false}]',
]);
print_r($result->toArray());
require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.document_ai.analyze(
document: Pathname("document.pdf"),
fields: "[{\"key\": \"employer_name\", \"name\": \"Employer name\", \"instruction\": \"The employer or company issuing the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": false}, {\"key\": \"employee_name\", \"name\": \"Employee name\", \"instruction\": \"The full name of the employee as printed on the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": true}, {\"key\": \"net_pay\", \"name\": \"Net pay\", \"instruction\": \"The net amount paid to the employee for the period.\", \"type\": \"number\", \"required\": true, \"is_full_name\": false}, {\"key\": \"pay_date\", \"name\": \"Pay date\", \"instruction\": \"The payment date shown on the payslip.\", \"type\": \"date\", \"required\": false, \"is_full_name\": false}]"
)
puts result.to_h
using System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.DocumentAi.AnalyzeAsync(new DocumentAiAnalyzeParams
{
Document = FileUpload.FromPath("document.pdf"),
Fields = "[{\"key\": \"employer_name\", \"name\": \"Employer name\", \"instruction\": \"The employer or company issuing the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": false}, {\"key\": \"employee_name\", \"name\": \"Employee name\", \"instruction\": \"The full name of the employee as printed on the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": true}, {\"key\": \"net_pay\", \"name\": \"Net pay\", \"instruction\": \"The net amount paid to the employee for the period.\", \"type\": \"number\", \"required\": true, \"is_full_name\": false}, {\"key\": \"pay_date\", \"name\": \"Pay date\", \"instruction\": \"The payment date shown on the payslip.\", \"type\": \"date\", \"required\": false, \"is_full_name\": false}]",
});
Console.WriteLine(JsonSerializer.Serialize(result));
curl --request POST \
--url https://verification.didit.me/v3/document-ai/ \
--header 'Content-Type: multipart/form-data' \
--header 'x-api-key: <api-key>' \
--form document=@example-file \
--form 'fields=[{"key": "employer_name", "name": "Employer name", "instruction": "The employer or company issuing the payslip.", "type": "text", "required": true, "is_full_name": false}, {"key": "employee_name", "name": "Employee name", "instruction": "The full name of the employee as printed on the payslip.", "type": "text", "required": true, "is_full_name": true}, {"key": "net_pay", "name": "Net pay", "instruction": "The net amount paid to the employee for the period.", "type": "number", "required": true, "is_full_name": false}, {"key": "pay_date", "name": "Pay date", "instruction": "The payment date shown on the payslip.", "type": "date", "required": false, "is_full_name": false}]' \
--form expected_first_name=Sophia \
--form expected_last_name=Martinez \
--form 'expected_company_name=<string>' \
--form 'expected_company_country=<string>' \
--form document_ai_name_match_score_threshold=80 \
--form document_ai_unreadable_document_action=REVIEW \
--form document_ai_missing_required_fields_action=REVIEW \
--form document_ai_document_tampering_action=DECLINE \
--form document_ai_name_mismatch_action=NO_ACTION \
--form document_ai_unsupported_file_action=REVIEW \
--form save_api_request=true \
--form vendor_data=user-123 \
--form 'metadata={
"flow": "onboarding"
}'
{ "request_id": "9d6a3b1e-2f0c-4a8e-9b7d-1c2e3f4a5b6c", "document_ai": { "status": "Approved", "extracted_data": { "employer_name": "Acme Payments Ltd", "employee_name": "Sophia Martinez", "net_pay": 3120.5, "pay_date": "2026-07-31" }, "detected_codes": [ { "type": "CODE_128", "page_number": 1, "position": [ [ 96, 456 ], [ 96, 616 ], [ 1012, 611 ], [ 1015, 456 ] ], "x": 96, "y": 456, "width": 919, "height": 160, "page_width": 1200, "page_height": 1700, "raw_payload": "SU5WLTIwMjYtMDA0Mg==", "parsed_payload": "INV-2026-0042" } ], "fields": [ { "key": "employer_name", "name": "Employer name", "instruction": "The employer or company issuing the payslip.", "type": "text", "required": true, "is_full_name": false }, { "key": "employee_name", "name": "Employee name", "instruction": "The full name of the employee as printed on the payslip.", "type": "text", "required": true, "is_full_name": true }, { "key": "net_pay", "name": "Net pay", "instruction": "The net amount paid to the employee for the period.", "type": "number", "required": true, "is_full_name": false }, { "key": "pay_date", "name": "Pay date", "instruction": "The payment date shown on the payslip.", "type": "date", "required": false, "is_full_name": false } ], "name_match_score": 100, "name_on_document": "Sophia Martinez", "warnings": [] }, "vendor_data": "user-123", "metadata": { "flow": "onboarding" }, "created_at": "2026-08-19T16:40:12.318Z"}
문서 한 개와 그 문서에서 읽어 올 필드 목록을 전송하십시오. Didit은 파일에 기본 추출 모델을 실행해 모든 필드를 타입과 함께 반환합니다(text, number, 또는 YYYY-MM-DD 형식의 date). 또한 지원되는 QR 코드와 바코드를 감지해 디코딩하고, 파일의 변조 여부를 확인하며, 원하는 경우 문서상의 이름을 기대하는 개인 또는 회사와 비교합니다. 급여명세서, 은행 거래내역서, 세무 서류, 청구서, 자금 증명, 또는 고정된 양식에 맞지 않는 모든 문서에 사용하십시오.이 기능은 호스팅 Document AI 단계의 서버 간 버전입니다. 요청은 multipart/form-data이며, 파일은 document에, 필드 정의는 fields에 하나의 JSON 인코딩 배열 문자열로 담아 보냅니다.
fields는 하나의 문자열로 전송되는 1개에서 30개 사이의 JSON 배열입니다. 각 항목에는 key(소문자, 숫자, 밑줄만 사용하며 요청 내에서 고유해야 함), 사람이 읽을 수 있는 name, 모델이 무엇을 찾아야 하는지 알려 주는 instruction, type(text, number, date 중 하나), 그리고 두 개의 플래그인 required와 is_full_name이 있습니다.
[ { "key": "account_holder", "name": "Account holder", "instruction": "Full name of the person or company the account belongs to", "type": "text", "required": true, "is_full_name": true }, { "key": "balance", "name": "Closing balance", "instruction": "Closing balance shown on the statement, as a number without the currency symbol", "type": "number", "required": true }, { "key": "currency", "name": "Currency", "instruction": "Three-letter currency code of the balance", "type": "text" }, { "key": "statement_date", "name": "Statement date", "instruction": "Date the statement was issued", "type": "date", "required": true }]
multipart 요청에서는 배열 전체가 하나의 폼 값입니다.
curl -X POST https://verification.didit.me/v3/document-ai/ \ -H "x-api-key: $DIDIT_API_KEY" \ -F "document=@./bank-statement.pdf" \ -F 'fields=[{"key":"account_holder","name":"Account holder","instruction":"Full name of the account holder","type":"text","required":true,"is_full_name":true},{"key":"balance","name":"Closing balance","instruction":"Closing balance as a number","type":"number","required":true}]' \ -F "expected_first_name=Jane" \ -F "expected_last_name=Doe"
응답은 정규화된 fields를 그대로 반환하고, extracted_data에 key 값을 기준으로 추출 결과를 담습니다. 모델이 찾지 못한 값은 null로 반환됩니다. 각 항목의 name, instruction, type은 선택 사항이며(type의 기본값은 text), key만 필수입니다. fields를 대괄호 형식의 폼 키(fields[0][key]=...)로 보내거나 JSON 배열이 아닌 형식으로 보내면, 추출이 시작되기 전에 400이 반환되며 요금은 청구되지 않습니다.
성공한 모든 응답에는 document_ai.detected_codes가 포함됩니다. 각 항목에는 다음 필드가 있습니다.
필드
설명
type
감지된 심볼로지(QR_CODE, CODE_128, EAN_13, DATA_MATRIX, PDF_417 등)
page_number
1부터 시작하는 페이지 번호
position
렌더링된 페이지 픽셀 기준으로 감지된 다각형 좌표이며, 신뢰할 수 있는 위치 정보가 없으면 null
x, y, width, height
렌더링된 페이지 픽셀 기준의 경계 상자이며, 신뢰할 수 있는 위치 정보가 없으면 null
page_width, page_height
좌표 계산에 사용된 렌더링 페이지의 크기
parsed_payload
디코딩된 문자열 또는 구조화된 값이며, 코드의 위치만 확인할 수 있는 경우 null
raw_payload
가능한 경우 디코더의 원시 payload를 base64 문자열로 반환하며, 그렇지 않으면 빈 문자열
이 배열은 PDF의 처리된 모든 페이지를 포함하며, 지원되는 코드가 없으면 비어 있습니다. Didit은 payload를 추측하지 않습니다. 손상된 QR 코드는 위치 정보와 함께 parsed_payload: null로 반환될 수 있으며, 코드 감지에 실패하더라도 Document AI 요청은 실패하지 않습니다.
is_full_name: true는 최대 한 개의 필드에만 설정하고, 문서의 소유자로 예상하는 사람 또는 회사를 함께 전송합니다.
검증 대상
전송 항목
이름이 비교되는 대상
개인
expected_first_name + expected_last_name
개인의 전체 이름
회사
expected_company_name(선택 사항: expected_company_country, 2자리 ISO 코드)
회사명
두 그룹을 함께 보내지 말고 둘 중 하나만 보내야 합니다. 이름이 추출되고 예상 이름이 있으면, 응답에 name_match_score(0~100)와 name_on_document가 포함됩니다. 점수가 document_ai_name_match_score_threshold(기본값 80)보다 낮으면 DOCUMENT_AI_NAME_MISMATCH 경고가 발생하고 document_ai_name_mismatch_action이 적용됩니다. is_full_name으로 표시된 필드가 없으면, Didit은 키가 name, holder, full_name, account_holder처럼 이름으로 보이는 첫 번째 텍스트 필드를 사용합니다. 비교할 값을 직접 지정하려면 해당 필드에 명시적으로 표시하십시오. 문서에서 이름 값을 찾을 수 없거나 예상 이름을 보내지 않으면 이름 검사는 건너뛰며, name_match_score는 null이 됩니다.
아래의 각 위험은 요청별로 설정할 수 있는 작업 파라미터에 대응하며, 값은 DECLINE, REVIEW, NO_ACTION 중 하나입니다. 발생한 작업 중 가장 엄격한 작업이 document_ai.status를 결정하며(Declined > In Review > Approved), 발생한 모든 위험은 document_ai.warnings에 나열됩니다. 기본값은 호스팅 워크플로 단계와 같습니다. 각 위험이 감지되는 방식은 Document AI 규칙 및 경고를 참조하십시오.
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 를 참고하십시오.
판독할 문서입니다. 허용되는 확장자: tiff, jpg, jpeg, png, pdf, webp, zip. 최대 업로드 크기: 30 MB(더 큰 파일은 400으로 거부됨). 다중 페이지 PDF가 지원됩니다(지연 시간이 길어질 수 있음). 암호화된 PDF는 400으로 거부됩니다. 이미지는 처리 전에 자동으로 압축됩니다.
1–30개의 필드 정의가 포함된 JSON 인코딩 배열 문자열(최대 16KB)입니다. 각 항목: key(필수, ^[a-z0-9_]{1,64}$, 고유값 — extracted_data에서 반환되는 키), name(100자 이하, 메시지에 표시됨), instruction(500자 이하, 모델이 읽어야 하는 내용), type(기본값 text | number | date), required(부울, 기본값 false), is_full_name(부울, 기본값 false, 요청당 최대 1개). 대괄호 스타일 폼 배열, 잘못된 JSON, 중복된 키 또는 둘 이상의 is_full_name은 처리나 결제가 진행되기 전에 400을 반환합니다.
예시:
"[{\"key\": \"employer_name\", \"name\": \"Employer name\", \"instruction\": \"The employer or company issuing the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": false}, {\"key\": \"employee_name\", \"name\": \"Employee name\", \"instruction\": \"The full name of the employee as printed on the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": true}, {\"key\": \"net_pay\", \"name\": \"Net pay\", \"instruction\": \"The net amount paid to the employee for the period.\", \"type\": \"number\", \"required\": true, \"is_full_name\": false}, {\"key\": \"pay_date\", \"name\": \"Pay date\", \"instruction\": \"The payment date shown on the payslip.\", \"type\": \"date\", \"required\": false, \"is_full_name\": false}]"
문서의 이름 필드와 대조하여 확인할 기업명입니다(기업 문서용). expected_first_name / expected_last_name과 함께 사용할 수 없습니다(예시 값은 의도적으로 제공되지 않음 — 생성된 요청 샘플에는 개인 필드가 사용되므로, 기업 문서를 확인할 때는 이 필드로 교체하십시오).
true(기본값)인 경우 호출을 API 유형 세션으로 저장합니다. Business Console에서 확인할 수 있고 반환된 request_id를 사용하여 GET /v3/session/{sessionId}/decision/을 통해 조회할 수 있으며 업로드된 문서, 추출된 값, 필드 정의 및 이름 일치 스냅샷이 저장됩니다. false인 경우 아무것도 저장되지 않고 request_id는 응답 상관관계 식별 전용의 일시적인 UUID이지만 호출에 대한 요금은 여전히 청구됩니다.
세션과 함께 저장되고(save_api_request=true인 경우) 응답에 그대로 반환되는 선택적 JSON 객체입니다. multipart 요청에서는 JSON 인코딩된 문자열 필드(예: metadata={"flow":"onboarding"})로 전송하십시오. 객체로 파싱됩니다.
예시:
{ "flow": "onboarding" }
응답
문서가 처리되었습니다. document_ai.status는 Approved, Declined 또는 In Review입니다. 감지된 모든 문제는 document_ai.warnings에 항목별로 나열됩니다. 문제가 있는 문서라도 200을 반환하므로 HTTP 코드뿐만 아니라 본문도 검사해야 합니다. save_api_request=true인 경우 request_id는 저장된 세션 ID입니다.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Didit Docs","description":"The best way to integrate identity and fraud checks into your app. One API, four product lines (KYC · KYB · Transaction Monitoring · Wallet Screening), 220+ countries, 14,000+ documents, sub-2s inference, $10 free credit/month.","colors":{"primary":"#2567FF","light":"#90B1FF","dark":"#1B4FE0"},"logo":{"light":"https://mintcdn.com/didit-0f962782/dCzNNoYCusBNdK3I/logo/didit.svg?fit=max\u0026auto=format\u0026n=dCzNNoYCusBNdK3I\u0026q=85\u0026s=9f162fb8295fa1fd9300a24b293ce0b7","dark":"https://mintcdn.com/didit-0f962782/TefoKXCbZA_GIK5a/logo/didit-logo-wordmark-white.svg?fit=max\u0026auto=format\u0026n=TefoKXCbZA_GIK5a\u0026q=85\u0026s=c8c541689c814ca6a2c873cf6185a3a7","href":"https://docs.didit.me"},"favicon":"https://mintcdn.com/didit-0f962782/t6r0B-WdGMU5mSS-/favicon.ico?fit=max\u0026auto=format\u0026n=t6r0B-WdGMU5mSS-\u0026q=85\u0026s=b291917b960ebe959ae3b1aa233eafa8","api":{"examples":{"prefill":true},"mdx":{"auth":{"method":"key","name":"x-api-key"},"server":"https://verification.didit.me"}},"background":{"color":{"light":"#FFFFFF","dark":"#1A1A1A"}},"navbar":{"links":[{"icon":"comment-dots","href":"https://help.didit.me","label":"Support"},{"icon":"signal","href":"https://status.didit.me","label":"Status"}],"primary":{"type":"button","label":"Sign in","href":"https://business.didit.me"}},"footer":{"socials":{"x":"https://x.com/didit","github":"https://github.com/didit-protocol","linkedin":"https://linkedin.com/company/91001155","website":"https://didit.me"}},"search":{"prompt":"Search Didit docs..."},"seo":{"metatags":{"twitter:site":"@didit","theme-color":"#2567FF","apple-mobile-web-app-title":"Didit Docs"},"organization":{"id":"https://didit.me/#organization","name":"Didit","legalName":"Didit Protocol","url":"https://didit.me","logo":"https://didit.me/logos/primary-horizontal-light.png","sameAs":["https://www.linkedin.com/company/91001155","https://www.youtube.com/@getdidit","https://github.com/didit-protocol","https://x.com/didit"]},"indexing":"navigable"},"fonts":{"heading":{"family":"Inter","weight":500},"body":{"family":"Inter","weight":400}},"errors":{"404":{"redirect":false,"title":"Page not found","description":"This page moved or never existed. [Back to docs](/)"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"thumbnails":{"appearance":"light","background":"https://mintcdn.com/didit-0f962782/Xkecx-xLq1K2abHK/images/og-thumbnail-backplate.png?fit=max\u0026auto=format\u0026n=Xkecx-xLq1K2abHK\u0026q=85\u0026s=c699fa252554b2ac8d4c631e209a1473","fonts":{"family":"Inter"}},"metadata":{"timestamp":true},"styling":{"latex":true},"navigation":{"languages":[{"language":"en","href":""},{"language":"es","navbar":{"links":[{"icon":"comment-dots","href":"https://help.didit.me","label":"Soporte"},{"icon":"signal","href":"https://status.didit.me","label":"Estado"}],"primary":{"type":"button","label":"Iniciar sesión","href":"https://business.didit.me"}},"href":"es"},{"language":"pt-BR","navbar":{"links":[{"icon":"comment-dots","href":"https://help.didit.me","label":"Suporte"},{"icon":"signal","href":"https://status.didit.me","label":"Status"}],"primary":{"type":"button","label":"Entrar","href":"https://business.didit.me"}},"href":"pt-br"},{"language":"ja","navbar":{"links":[{"icon":"comment-dots","href":"https://help.didit.me","label":"サポート"},{"icon":"signal","href":"https://status.didit.me","label":"ステータス"}],"primary":{"type":"button","label":"サインイン","href":"https://business.didit.me"}},"href":"ja"},{"language":"de","navbar":{"links":[{"icon":"comment-dots","href":"https://help.didit.me","label":"Support"},{"icon":"signal","href":"https://status.didit.me","label":"Status"}],"primary":{"type":"button","label":"Anmelden","href":"https://business.didit.me"}},"href":"de"},{"language":"fr","navbar":{"links":[{"icon":"comment-dots","href":"https://help.didit.me","label":"Assistance"},{"icon":"signal","href":"https://status.didit.me","label":"Statut"}],"primary":{"type":"button","label":"Se connecter","href":"https://business.didit.me"}},"href":"fr"},{"language":"it","navbar":{"links":[{"icon":"comment-dots","href":"https://help.didit.me","label":"Supporto"},{"icon":"signal","href":"https://status.didit.me","label":"Stato"}],"primary":{"type":"button","label":"Accedi","href":"https://business.didit.me"}},"href":"it"},{"language":"pt","navbar":{"links":[{"icon":"comment-dots","href":"https://help.didit.me","label":"Suporte"},{"icon":"signal","href":"https://status.didit.me","label":"Estado"}],"primary":{"type":"button","label":"Iniciar sessão","href":"https://business.didit.me"}},"href":"pt"},{"language":"ca","navbar":{"links":[{"icon":"comment-dots","href":"https://help.didit.me","label":"Suport"},{"icon":"signal","href":"https://status.didit.me","label":"Estat"}],"primary":{"type":"button","label":"Inicia la sessió","href":"https://business.didit.me"}},"href":"ca"},{"language":"id","navbar":{"links":[{"icon":"comment-dots","href":"https://help.didit.me","label":"Dukungan"},{"icon":"signal","href":"https://status.didit.me","label":"Status"}],"primary":{"type":"button","label":"Masuk","href":"https://business.didit.me"}},"href":"id"},{"language":"ru","navbar":{"links":[{"icon":"comment-dots","href":"https://help.didit.me","label":"Поддержка"},{"icon":"signal","href":"https://status.didit.me","label":"Статус"}],"primary":{"type":"button","label":"Вход","href":"https://business.didit.me"}},"href":"ru"},{"language":"ko","navbar":{"links":[{"icon":"comment-dots","href":"https://help.didit.me","label":"지원"},{"icon":"signal","href":"https://status.didit.me","label":"상태"}],"primary":{"type":"button","label":"로그인","href":"https://business.didit.me"}},"href":"ko"},{"language":"zh","navbar":{"links":[{"icon":"comment-dots","href":"https://help.didit.me","label":"支持"},{"icon":"signal","href":"https://status.didit.me","label":"状态"}],"primary":{"type":"button","label":"登录","href":"https://business.didit.me"}},"href":"zh"},{"language":"ar","navbar":{"links":[{"icon":"comment-dots","href":"https://help.didit.me","label":"الدعم"},{"icon":"signal","href":"https://status.didit.me","label":"الحالة"}],"primary":{"type":"button","label":"تسجيل الدخول","href":"https://business.didit.me"}},"href":"ar"},{"language":"hi","navbar":{"links":[{"icon":"comment-dots","href":"https://help.didit.me","label":"सहायता"},{"icon":"signal","href":"https://status.didit.me","label":"स्थिति"}],"primary":{"type":"button","label":"साइन इन करें","href":"https://business.didit.me"}},"href":"hi"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"didit-0f962782","hasAudioNarration":false,"actualSubdomain":"didit-0f962782","customDomains":["docs.didit.me"],"gitSource":{"type":"github","owner":"didit-protocol","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aef60ae8e01a92054befade","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"ar","tag":"مرجع API","count":432},{"language":"ca","tag":"Referència de l'API","count":432},{"language":"de","tag":"API-Referenz","count":432},{"language":"es","tag":"Referencia de la API","count":432},{"language":"fr","tag":"Référence API","count":432},{"language":"hi","tag":"API संदर्भ","count":432},{"language":"id","tag":"Referensi API","count":432},{"language":"it","tag":"Riferimento API","count":432},{"language":"ja","tag":"APIリファレンス","count":432},{"language":"ko","tag":"API 레퍼런스","count":432},{"language":"pt-BR","tag":"Referência da API","count":432},{"language":"pt","tag":"Referência da API","count":432},{"language":"ru","tag":"Справочник API","count":432},{"language":"zh","tag":"API 参考","count":432},{"language":"en","tag":"API Reference","count":424},{"language":"en","tag":"Database Validation","count":129},{"language":"ar","tag":"التحقق من قواعد البيانات","count":129},{"language":"ca","tag":"Validació en bases de dades","count":129},{"language":"de","tag":"Datenbankvalidierung","count":129},{"language":"es","tag":"Validación de base de datos","count":129},{"language":"fr","tag":"Validation en base de données","count":129},{"language":"hi","tag":"डेटाबेस सत्यापन","count":129},{"language":"id","tag":"Validasi Database","count":129},{"language":"it","tag":"Validazione su database","count":129},{"language":"ja","tag":"データベース検証","count":129},{"language":"ko","tag":"데이터베이스 검증","count":129},{"language":"pt-BR","tag":"Validação de banco de dados","count":129},{"language":"pt","tag":"Validação de base de dados","count":129},{"language":"ru","tag":"Проверка по базам данных","count":129},{"language":"zh","tag":"数据库核验","count":129},{"language":"ca","tag":"Primers passos","count":93},{"language":"de","tag":"Erste Schritte","count":93},{"language":"es","tag":"Primeros pasos","count":93},{"language":"ja","tag":"はじめに","count":93},{"language":"ko","tag":"시작하기","count":93},{"language":"pt-BR","tag":"Primeiros passos","count":93},{"language":"ru","tag":"Начало работы","count":93},{"language":"en","tag":"Get Started","count":87},{"language":"ar","tag":"ابدأ الآن","count":87},{"language":"fr","tag":"Commencer","count":87},{"language":"hi","tag":"शुरू करें","count":87},{"language":"id","tag":"Mulai","count":87},{"language":"it","tag":"Inizia","count":87},{"language":"pt","tag":"Começar","count":87},{"language":"zh","tag":"快速开始","count":87},{"language":"ko","tag":"인증","count":85},{"language":"en","tag":"User Verification","count":74},{"language":"ar","tag":"التحقق من المستخدمين","count":74},{"language":"ca","tag":"Verificació d'usuaris","count":74},{"language":"de","tag":"Benutzerverifizierung","count":74},{"language":"es","tag":"Verificación de usuarios","count":74},{"language":"fr","tag":"Vérification des utilisateurs","count":74},{"language":"hi","tag":"उपयोगकर्ता सत्यापन","count":74},{"language":"id","tag":"Verifikasi Pengguna","count":74},{"language":"it","tag":"Verifica degli utenti","count":74},{"language":"ja","tag":"ユーザー認証","count":74},{"language":"ko","tag":"사용자 인증","count":74},{"language":"pt-BR","tag":"Verificação de usuários","count":74},{"language":"pt","tag":"Verificação de utilizadores","count":74},{"language":"ru","tag":"Проверка пользователей","count":74},{"language":"zh","tag":"用户验证","count":74},{"language":"en","tag":"Integrate / SDKs","count":62},{"language":"ar","tag":"التكامل / SDKs","count":62},{"language":"ca","tag":"Integració / SDK","count":62},{"language":"de","tag":"Integrieren / SDKs","count":62},{"language":"es","tag":"Integración / SDKs","count":62},{"language":"fr","tag":"Intégrer / SDK","count":62},{"language":"hi","tag":"इंटीग्रेट करें / SDK","count":62},{"language":"id","tag":"Integrasi / SDK","count":62},{"language":"it","tag":"Integrazione / SDK","count":62},{"language":"ja","tag":"連携 / SDK","count":62},{"language":"ko","tag":"연동 / SDK","count":62},{"language":"pt-BR","tag":"Integração / SDKs","count":62},{"language":"pt","tag":"Integrar / SDKs","count":62},{"language":"ru","tag":"Интеграция / SDK","count":62},{"language":"zh","tag":"集成 / SDK","count":62},{"language":"en","tag":"Travel Rule","count":55},{"language":"ar","tag":"Travel Rule","count":55},{"language":"ca","tag":"Travel Rule","count":55},{"language":"de","tag":"Travel Rule","count":55},{"language":"es","tag":"Travel Rule","count":55},{"language":"fr","tag":"Travel Rule","count":55},{"language":"hi","tag":"Travel Rule","count":55},{"language":"id","tag":"Travel Rule","count":55},{"language":"it","tag":"Travel Rule","count":55},{"language":"ja","tag":"トラベルルール","count":55},{"language":"ko","tag":"Travel Rule","count":55},{"language":"pt-BR","tag":"Travel Rule","count":55},{"language":"pt","tag":"Travel Rule","count":55},{"language":"ru","tag":"Travel Rule","count":55},{"language":"zh","tag":"Travel Rule","count":55},{"language":"en","tag":"Verification","count":48},{"language":"ar","tag":"التحقق","count":48},{"language":"ca","tag":"Verificació","count":48},{"language":"de","tag":"Verifizierung","count":48},{"language":"es","tag":"Verificación","count":48},{"language":"fr","tag":"Vérification","count":48},{"language":"hi","tag":"सत्यापन","count":48},{"language":"id","tag":"Verifikasi","count":48},{"language":"it","tag":"Verifica","count":48},{"language":"ja","tag":"検証","count":48},{"language":"pt-BR","tag":"Verificação","count":48},{"language":"pt","tag":"Verificação","count":48},{"language":"ru","tag":"Верификация","count":48},{"language":"zh","tag":"验证","count":48},{"language":"en","tag":"Authentication","count":37},{"language":"ar","tag":"المصادقة","count":37},{"language":"ca","tag":"Autenticació","count":37},{"language":"de","tag":"Authentifizierung","count":37},{"language":"es","tag":"Autenticación","count":37},{"language":"fr","tag":"Authentification","count":37},{"language":"hi","tag":"प्रमाणीकरण","count":37},{"language":"id","tag":"Autentikasi","count":37},{"language":"it","tag":"Autenticazione","count":37},{"language":"ja","tag":"認証","count":37},{"language":"pt-BR","tag":"Autenticação","count":37},{"language":"pt","tag":"Autenticação","count":37},{"language":"ru","tag":"Аутентификация","count":37},{"language":"zh","tag":"身份认证","count":37},{"language":"en","tag":"Digital ID wallets","count":35},{"language":"en","tag":"User and Business Verifications","count":35},{"language":"ar","tag":"محافظ الهوية الرقمية","count":35},{"language":"ar","tag":"التحقق من المستخدمين والشركات","count":35},{"language":"ca","tag":"Carteres d'identitat digital","count":35},{"language":"ca","tag":"Verificacions d'usuaris i empreses","count":35},{"language":"de","tag":"Digitale ID-Wallets","count":35},{"language":"de","tag":"Benutzer- und Unternehmensverifizierungen","count":35},{"language":"es","tag":"Wallets de identidad digital","count":35},{"language":"es","tag":"Verificaciones de usuarios y empresas","count":35},{"language":"fr","tag":"Portefeuilles d'identité numérique","count":35},{"language":"fr","tag":"Vérifications des utilisateurs et des entreprises","count":35},{"language":"hi","tag":"डिजिटल ID वॉलेट","count":35},{"language":"hi","tag":"उपयोगकर्ता और व्यवसाय सत्यापन","count":35},{"language":"id","tag":"Dompet ID Digital","count":35},{"language":"id","tag":"Verifikasi Pengguna dan Bisnis","count":35},{"language":"it","tag":"Wallet di identità digitale","count":35},{"language":"it","tag":"Verifiche di utenti e aziende","count":35},{"language":"ja","tag":"デジタルIDウォレット","count":35},{"language":"ja","tag":"ユーザーと企業の認証","count":35},{"language":"ko","tag":"디지털 신분증 지갑","count":35},{"language":"ko","tag":"사용자 인증 및 기업 확인","count":35},{"language":"pt-BR","tag":"Carteiras de identidade digital","count":35},{"language":"pt-BR","tag":"Verificações de usuários e empresas","count":35},{"language":"pt","tag":"Carteiras de identidade digital","count":35},{"language":"pt","tag":"Verificações de utilizadores e empresas","count":35},{"language":"ru","tag":"Цифровые ID-кошельки","count":35},{"language":"ru","tag":"Верификация пользователей и компаний","count":35},{"language":"zh","tag":"数字身份钱包","count":35},{"language":"zh","tag":"用户与企业验证","count":35},{"language":"ko","tag":"거래 모니터링","count":28}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","href":"/_mintlify/custom/didit-0f962782/714dd91730ddd114/style.css"}],"page":{"pagePath":"ko/standalone-apis/document-ai","slug":"/ko/standalone-apis/document-ai","pageMetadata":{"title":"문서 AI API: 맞춤형 문서 데이터 추출","sidebarTitle":"문서 AI API","description":"POST /v3/document-ai/로 PDF나 이미지에서 정의한 필드를 서버 간 방식으로 추출하며, 이름 대조와 위변조 검사를 지원합니다. Didit 기준 문서당 $0.20.","keywords":["문서 AI API","문서 데이터 추출 API","맞춤형 문서 OCR API","자금 증명 API","급여명세서 추출 API","은행 거래내역 OCR","KYC 문서 추출","문서 위변조 탐지","Didit API"],"openapi":"ko/openapi-25.json POST /v3/document-ai/","href":"/ko/standalone-apis/document-ai"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"POST /v3/document-ai/로 PDF나 이미지에서 정의한 필드를 서버 간 방식으로 추출하며, 이름 대조와 위변조 검사를 지원합니다. Didit 기준 문서당 $0.20.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`문서 한 개와 그 문서에서 읽어 올 필드 목록을 전송하십시오. Didit은 파일에 기본 추출 모델을 실행해 모든 필드를 타입과 함께 반환합니다(`,_jsx(_components.code,{children:`text`}),`, `,_jsx(_components.code,{children:`number`}),`, 또는 `,_jsx(_components.code,{children:`YYYY-MM-DD`}),` 형식의 `,_jsx(_components.code,{children:`date`}),`). 또한 지원되는 QR 코드와 바코드를 감지해 디코딩하고, 파일의 변조 여부를 확인하며, 원하는 경우 문서상의 이름을 기대하는 개인 또는 회사와 비교합니다. 급여명세서, 은행 거래내역서, 세무 서류, 청구서, 자금 증명, 또는 고정된 양식에 맞지 않는 모든 문서에 사용하십시오.`]}),`\n`,_jsxs(_components.p,{children:[`이 기능은 호스팅 `,_jsx(_components.a,{href:`/ko/core-technology/document-ai/overview`,children:`Document AI`}),` 단계의 서버 간 버전입니다. 요청은 `,_jsx(_components.code,{children:`multipart/form-data`}),`이며, 파일은 `,_jsx(_components.code,{children:`document`}),`에, 필드 정의는 `,_jsx(_components.code,{children:`fields`}),`에 하나의 JSON 인코딩 배열 문자열로 담아 보냅니다.`]}),`\n`,_jsx(Heading,{level:`2`,id:`추출할-필드-정의`,children:`추출할 필드 정의`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`fields`}),`는 하나의 문자열로 전송되는 1개에서 30개 사이의 JSON 배열입니다. 각 항목에는 `,_jsx(_components.code,{children:`key`}),`(소문자, 숫자, 밑줄만 사용하며 요청 내에서 고유해야 함), 사람이 읽을 수 있는 `,_jsx(_components.code,{children:`name`}),`, 모델이 무엇을 찾아야 하는지 알려 주는 `,_jsx(_components.code,{children:`instruction`}),`, `,_jsx(_components.code,{children:`type`}),`(`,_jsx(_components.code,{children:`text`}),`, `,_jsx(_components.code,{children:`number`}),`, `,_jsx(_components.code,{children:`date`}),` 중 하나), 그리고 두 개의 플래그인 `,_jsx(_components.code,{children:`required`}),`와 `,_jsx(_components.code,{children:`is_full_name`}),`이 있습니다.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`30`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`30`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`[`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"account_holder\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Account holder\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"instruction\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Full name of the person or company the account belongs to\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"text\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"required\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"is_full_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"balance\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Closing balance\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"instruction\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Closing balance shown on the statement, as a number without the currency symbol\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"number\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"required\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"currency\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Currency\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"instruction\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Three-letter currency code of the balance\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"text\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"statement_date\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Statement date\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"instruction\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Date the statement was issued\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"date\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"required\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`multipart 요청에서는 배열 전체가 하나의 폼 값입니다.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`6`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://verification.didit.me/v3/document-ai/`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-api-key: `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$DIDIT_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -F`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"document=@./bank-statement.pdf\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -F`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'fields=[{\"key\":\"account_holder\",\"name\":\"Account holder\",\"instruction\":\"Full name of the account holder\",\"type\":\"text\",\"required\":true,\"is_full_name\":true},{\"key\":\"balance\",\"name\":\"Closing balance\",\"instruction\":\"Closing balance as a number\",\"type\":\"number\",\"required\":true}]'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -F`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"expected_first_name=Jane\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -F`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"expected_last_name=Doe\"`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`응답은 정규화된 `,_jsx(_components.code,{children:`fields`}),`를 그대로 반환하고, `,_jsx(_components.code,{children:`extracted_data`}),`에 `,_jsx(_components.code,{children:`key`}),` 값을 기준으로 추출 결과를 담습니다. 모델이 찾지 못한 값은 `,_jsx(_components.code,{children:`null`}),`로 반환됩니다. 각 항목의 `,_jsx(_components.code,{children:`name`}),`, `,_jsx(_components.code,{children:`instruction`}),`, `,_jsx(_components.code,{children:`type`}),`은 선택 사항이며(`,_jsx(_components.code,{children:`type`}),`의 기본값은 `,_jsx(_components.code,{children:`text`}),`), `,_jsx(_components.code,{children:`key`}),`만 필수입니다. `,_jsx(_components.code,{children:`fields`}),`를 대괄호 형식의 폼 키(`,_jsx(_components.code,{children:`fields[0][key]=...`}),`)로 보내거나 JSON 배열이 아닌 형식으로 보내면, 추출이 시작되기 전에 `,_jsx(_components.code,{children:`400`}),`이 반환되며 요금은 청구되지 않습니다.`]}),`\n`,_jsx(Heading,{level:`2`,id:`qr-코드-및-바코드`,children:`QR 코드 및 바코드`}),`\n`,_jsxs(_components.p,{children:[`성공한 모든 응답에는 `,_jsx(_components.code,{children:`document_ai.detected_codes`}),`가 포함됩니다. 각 항목에는 다음 필드가 있습니다.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`필드`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`type`})}),_jsxs(_components.td,{children:[`감지된 심볼로지(`,_jsx(_components.code,{children:`QR_CODE`}),`, `,_jsx(_components.code,{children:`CODE_128`}),`, `,_jsx(_components.code,{children:`EAN_13`}),`, `,_jsx(_components.code,{children:`DATA_MATRIX`}),`, `,_jsx(_components.code,{children:`PDF_417`}),` 등)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`page_number`})}),_jsx(_components.td,{children:`1부터 시작하는 페이지 번호`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`position`})}),_jsxs(_components.td,{children:[`렌더링된 페이지 픽셀 기준으로 감지된 다각형 좌표이며, 신뢰할 수 있는 위치 정보가 없으면 `,_jsx(_components.code,{children:`null`})]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`x`}),`, `,_jsx(_components.code,{children:`y`}),`, `,_jsx(_components.code,{children:`width`}),`, `,_jsx(_components.code,{children:`height`})]}),_jsxs(_components.td,{children:[`렌더링된 페이지 픽셀 기준의 경계 상자이며, 신뢰할 수 있는 위치 정보가 없으면 `,_jsx(_components.code,{children:`null`})]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`page_width`}),`, `,_jsx(_components.code,{children:`page_height`})]}),_jsx(_components.td,{children:`좌표 계산에 사용된 렌더링 페이지의 크기`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`parsed_payload`})}),_jsxs(_components.td,{children:[`디코딩된 문자열 또는 구조화된 값이며, 코드의 위치만 확인할 수 있는 경우 `,_jsx(_components.code,{children:`null`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`raw_payload`})}),_jsx(_components.td,{children:`가능한 경우 디코더의 원시 payload를 base64 문자열로 반환하며, 그렇지 않으면 빈 문자열`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`이 배열은 PDF의 처리된 모든 페이지를 포함하며, 지원되는 코드가 없으면 비어 있습니다. Didit은 payload를 추측하지 않습니다. 손상된 QR 코드는 위치 정보와 함께 `,_jsx(_components.code,{children:`parsed_payload: null`}),`로 반환될 수 있으며, 코드 감지에 실패하더라도 Document AI 요청은 실패하지 않습니다.`]}),`\n`,_jsx(Heading,{level:`2`,id:`이름-대조`,children:`이름 대조`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`is_full_name: true`}),`는 최대 한 개의 필드에만 설정하고, 문서의 소유자로 예상하는 사람 또는 회사를 함께 전송합니다.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`검증 대상`}),_jsx(_components.th,{children:`전송 항목`}),_jsx(_components.th,{children:`이름이 비교되는 대상`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`개인`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`expected_first_name`}),` + `,_jsx(_components.code,{children:`expected_last_name`})]}),_jsx(_components.td,{children:`개인의 전체 이름`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`회사`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`expected_company_name`}),`(선택 사항: `,_jsx(_components.code,{children:`expected_company_country`}),`, 2자리 ISO 코드)`]}),_jsx(_components.td,{children:`회사명`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`두 그룹을 함께 보내지 말고 둘 중 하나만 보내야 합니다. 이름이 추출되고 예상 이름이 있으면, 응답에 `,_jsx(_components.code,{children:`name_match_score`}),`(0~100)와 `,_jsx(_components.code,{children:`name_on_document`}),`가 포함됩니다. 점수가 `,_jsx(_components.code,{children:`document_ai_name_match_score_threshold`}),`(기본값 `,_jsx(_components.code,{children:`80`}),`)보다 낮으면 `,_jsx(_components.code,{children:`DOCUMENT_AI_NAME_MISMATCH`}),` 경고가 발생하고 `,_jsx(_components.code,{children:`document_ai_name_mismatch_action`}),`이 적용됩니다. `,_jsx(_components.code,{children:`is_full_name`}),`으로 표시된 필드가 없으면, Didit은 키가 `,_jsx(_components.code,{children:`name`}),`, `,_jsx(_components.code,{children:`holder`}),`, `,_jsx(_components.code,{children:`full_name`}),`, `,_jsx(_components.code,{children:`account_holder`}),`처럼 이름으로 보이는 첫 번째 텍스트 필드를 사용합니다. 비교할 값을 직접 지정하려면 해당 필드에 명시적으로 표시하십시오. 문서에서 이름 값을 찾을 수 없거나 예상 이름을 보내지 않으면 이름 검사는 건너뛰며, `,_jsx(_components.code,{children:`name_match_score`}),`는 `,_jsx(_components.code,{children:`null`}),`이 됩니다.`]}),`\n`,_jsx(Heading,{level:`2`,id:`위험-및-작업`,children:`위험 및 작업`}),`\n`,_jsxs(_components.p,{children:[`아래의 각 위험은 요청별로 설정할 수 있는 작업 파라미터에 대응하며, 값은 `,_jsx(_components.code,{children:`DECLINE`}),`, `,_jsx(_components.code,{children:`REVIEW`}),`, `,_jsx(_components.code,{children:`NO_ACTION`}),` 중 하나입니다. 발생한 작업 중 가장 엄격한 작업이 `,_jsx(_components.code,{children:`document_ai.status`}),`를 결정하며(`,_jsx(_components.code,{children:`Declined`}),` > `,_jsx(_components.code,{children:`In Review`}),` > `,_jsx(_components.code,{children:`Approved`}),`), 발생한 모든 위험은 `,_jsx(_components.code,{children:`document_ai.warnings`}),`에 나열됩니다. 기본값은 호스팅 워크플로 단계와 같습니다. 각 위험이 감지되는 방식은 `,_jsx(_components.a,{href:`/ko/core-technology/document-ai/warnings-document-ai`,children:`Document AI 규칙 및 경고`}),`를 참조하십시오.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`위험`}),_jsx(_components.th,{children:`파라미터`}),_jsx(_components.th,{children:`기본값`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`DOCUMENT_AI_UNREADABLE_DOCUMENT`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`document_ai_unreadable_document_action`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`REVIEW`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`DOCUMENT_AI_MISSING_REQUIRED_FIELDS`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`document_ai_missing_required_fields_action`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`REVIEW`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`DOCUMENT_AI_SUSPECTED_MANIPULATION`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`document_ai_document_tampering_action`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`DECLINE`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`DOCUMENT_AI_NAME_MISMATCH`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`document_ai_name_mismatch_action`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`NO_ACTION`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`DOCUMENT_AI_UNSUPPORTED_FILE`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`document_ai_unsupported_file_action`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`REVIEW`})})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`파일-저장-및-요금-청구`,children:`파일, 저장 및 요금 청구`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`지원 파일:`}),` PDF(여러 페이지 지원), JPG, JPEG, PNG, TIFF, WebP, 또는 문서가 포함된 ZIP 파일이며, 최대 30MB입니다. 암호화된 PDF는 `,_jsx(_components.code,{children:`400`}),`을 반환합니다. 복호화된 PDF나 사진을 업로드하십시오.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`save_api_request`})}),`(기본값 `,_jsx(_components.code,{children:`true`}),`): 요청, 추출된 필드, 감지된 코드가 `,_jsx(_components.strong,{children:`Manual Checks`}),` 메뉴에서 Business Console에 표시되어 팀이 검토할 수 있습니다. 저장을 건너뛰려면 `,_jsx(_components.code,{children:`false`}),`로 설정하십시오.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(`strong`,{children:_jsx(_components.code,{children:`vendor_data`})}),`와 `,_jsx(`strong`,{children:_jsx(_components.code,{children:`metadata`})}),`는 응답에 변경 없이 그대로 반환되므로, 결과를 자체 기록과 연결할 수 있습니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`요금:`}),` 문서당 $0.20이며, 문서가 처리되고 상태가 반환될 때 청구됩니다. 요금제에 따른 할인이 적용됩니다. `,_jsx(_components.a,{href:`/ko/getting-started/pricing#%EB%8B%A8%EB%8F%85-api-%EC%9A%94%EA%B8%88-%EC%84%9C%EB%B2%84-%EA%B0%84`,children:`요금`}),`을 참조하십시오.`]}),`\n`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`사용자가 직접 문서를 업로드하도록 하거나, 한 번의 흐름에서 문서를 최대 3개까지 수집하거나, 업로드 화면을 자동 번역하거나, 추출된 필드를 신분증 또는 설문지 데이터와 대조해야 합니까? 그렇다면 대신 호스팅 `,_jsx(_components.a,{href:`/ko/core-technology/document-ai/overview`,children:`Document AI 워크플로 단계`}),`를 사용하십시오.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"문서 AI API: 맞춤형 문서 데이터 추출","sidebarTitle":"문서 AI API","description":"POST /v3/document-ai/로 PDF나 이미지에서 정의한 필드를 서버 간 방식으로 추출하며, 이름 대조와 위변조 검사를 지원합니다. Didit 기준 문서당 $0.20.","keywords":["문서 AI API","문서 데이터 추출 API","맞춤형 문서 OCR API","자금 증명 API","급여명세서 추출 API","은행 거래내역 OCR","KYC 문서 추출","문서 위변조 탐지","Didit API"],"openapi":"ko/openapi-25.json POST /v3/document-ai/","href":"/ko/standalone-apis/document-ai"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"추출할 필드 정의","slug":"추출할-필드-정의","depth":2,"children":[]},{"title":"QR 코드 및 바코드","slug":"qr-코드-및-바코드","depth":2,"children":[]},{"title":"이름 대조","slug":"이름-대조","depth":2,"children":[]},{"title":"위험 및 작업","slug":"위험-및-작업","depth":2,"children":[]},{"title":"파일, 저장 및 요금 청구","slug":"파일-저장-및-요금-청구","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/didit-0f962782/5fb7c0c336c92274/snippets/data/database-validation-coverage.js","/_mintlify/custom/didit-0f962782/4ac7d3c2a19a354d/database-validation-playground.js"],"openApiReferenceData":{"operation":{"summary":"Document AI(사용자 정의 필드 추출 + 위변조 검사)","description":"POST /v3/document-ai/로 PDF나 이미지에서 정의한 필드를 서버 간 방식으로 추출하며, 이름 대조와 위변조 검사를 지원합니다. Didit 기준 문서당 $0.20.","operationId":"post_v3document-ai","x-didit-sdk":{"resource":"document_ai","method":"analyze","auth":"api_key","server":true},"tags":["Standalone APIs"],"security":["69720626-394d-4f9a-9d83-e76a1f94405d"],"requestBody":"863efe8e-9fb5-461c-a42a-fc72af36df26","responses":{"200":"e4f7b6c0-29bf-42a1-8f82-35050edc15b8","400":"60d6fe5f-9916-44a1-8ce2-faddf044382f","403":"87f1f38e-1da3-49f5-99ce-71e86ab8fc74","429":"9a0f9bd3-9087-432e-92e3-c4cbdbf12b2f","503":"7b850e16-d978-4bfc-b5e1-c8957aacf212"},"x-codeSamples":[{"lang":"python","label":"Python","source":"from didit import Didit\n\n# Reads DIDIT_API_KEY.\nclient = Didit()\n\nresult = client.document_ai.analyze(\n document=open(\"document.pdf\", \"rb\"),\n fields=\"[{\\\"key\\\": \\\"employer_name\\\", \\\"name\\\": \\\"Employer name\\\", \\\"instruction\\\": \\\"The employer or company issuing the payslip.\\\", \\\"type\\\": \\\"text\\\", \\\"required\\\": true, \\\"is_full_name\\\": false}, {\\\"key\\\": \\\"employee_name\\\", \\\"name\\\": \\\"Employee name\\\", \\\"instruction\\\": \\\"The full name of the employee as printed on the payslip.\\\", \\\"type\\\": \\\"text\\\", \\\"required\\\": true, \\\"is_full_name\\\": true}, {\\\"key\\\": \\\"net_pay\\\", \\\"name\\\": \\\"Net pay\\\", \\\"instruction\\\": \\\"The net amount paid to the employee for the period.\\\", \\\"type\\\": \\\"number\\\", \\\"required\\\": true, \\\"is_full_name\\\": false}, {\\\"key\\\": \\\"pay_date\\\", \\\"name\\\": \\\"Pay date\\\", \\\"instruction\\\": \\\"The payment date shown on the payslip.\\\", \\\"type\\\": \\\"date\\\", \\\"required\\\": false, \\\"is_full_name\\\": false}]\",\n)\nprint(result)"},{"lang":"javascript","label":"Node.js","source":"import Didit, { fileFromPath } from \"@didit-protocol/sdk-node\";\n\n// Reads DIDIT_API_KEY.\nconst didit = new Didit();\n\nconst result = await didit.documentAi.analyze({\n document: await fileFromPath(\"document.pdf\"),\n fields: \"[{\\\"key\\\": \\\"employer_name\\\", \\\"name\\\": \\\"Employer name\\\", \\\"instruction\\\": \\\"The employer or company issuing the payslip.\\\", \\\"type\\\": \\\"text\\\", \\\"required\\\": true, \\\"is_full_name\\\": false}, {\\\"key\\\": \\\"employee_name\\\", \\\"name\\\": \\\"Employee name\\\", \\\"instruction\\\": \\\"The full name of the employee as printed on the payslip.\\\", \\\"type\\\": \\\"text\\\", \\\"required\\\": true, \\\"is_full_name\\\": true}, {\\\"key\\\": \\\"net_pay\\\", \\\"name\\\": \\\"Net pay\\\", \\\"instruction\\\": \\\"The net amount paid to the employee for the period.\\\", \\\"type\\\": \\\"number\\\", \\\"required\\\": true, \\\"is_full_name\\\": false}, {\\\"key\\\": \\\"pay_date\\\", \\\"name\\\": \\\"Pay date\\\", \\\"instruction\\\": \\\"The payment date shown on the payslip.\\\", \\\"type\\\": \\\"date\\\", \\\"required\\\": false, \\\"is_full_name\\\": false}]\",\n});\nconsole.log(result);"},{"lang":"go","label":"Go","source":"ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.DocumentAi.Analyze(ctx, didit.DocumentAiAnalyzeParams{\n\tDocument: didit.FileFromPath(\"document.pdf\"),\n\tFields: \"[{\\\"key\\\": \\\"employer_name\\\", \\\"name\\\": \\\"Employer name\\\", \\\"instruction\\\": \\\"The employer or company issuing the payslip.\\\", \\\"type\\\": \\\"text\\\", \\\"required\\\": true, \\\"is_full_name\\\": false}, {\\\"key\\\": \\\"employee_name\\\", \\\"name\\\": \\\"Employee name\\\", \\\"instruction\\\": \\\"The full name of the employee as printed on the payslip.\\\", \\\"type\\\": \\\"text\\\", \\\"required\\\": true, \\\"is_full_name\\\": true}, {\\\"key\\\": \\\"net_pay\\\", \\\"name\\\": \\\"Net pay\\\", \\\"instruction\\\": \\\"The net amount paid to the employee for the period.\\\", \\\"type\\\": \\\"number\\\", \\\"required\\\": true, \\\"is_full_name\\\": false}, {\\\"key\\\": \\\"pay_date\\\", \\\"name\\\": \\\"Pay date\\\", \\\"instruction\\\": \\\"The payment date shown on the payslip.\\\", \\\"type\\\": \\\"date\\\", \\\"required\\\": false, \\\"is_full_name\\\": false}]\",\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)"},{"lang":"java","label":"Java","source":"import java.nio.file.Path;\nimport me.didit.Didit;\nimport me.didit.types.DocumentAiAnalyzeParams;\n\n// Reads DIDIT_API_KEY.\nDidit client = new Didit();\n\nvar result = client.documentAi().analyze(DocumentAiAnalyzeParams.builder()\n .document(Path.of(\"document.pdf\"))\n .fields(\"[{\\\"key\\\": \\\"employer_name\\\", \\\"name\\\": \\\"Employer name\\\", \\\"instruction\\\": \\\"The employer or company issuing the payslip.\\\", \\\"type\\\": \\\"text\\\", \\\"required\\\": true, \\\"is_full_name\\\": false}, {\\\"key\\\": \\\"employee_name\\\", \\\"name\\\": \\\"Employee name\\\", \\\"instruction\\\": \\\"The full name of the employee as printed on the payslip.\\\", \\\"type\\\": \\\"text\\\", \\\"required\\\": true, \\\"is_full_name\\\": true}, {\\\"key\\\": \\\"net_pay\\\", \\\"name\\\": \\\"Net pay\\\", \\\"instruction\\\": \\\"The net amount paid to the employee for the period.\\\", \\\"type\\\": \\\"number\\\", \\\"required\\\": true, \\\"is_full_name\\\": false}, {\\\"key\\\": \\\"pay_date\\\", \\\"name\\\": \\\"Pay date\\\", \\\"instruction\\\": \\\"The payment date shown on the payslip.\\\", \\\"type\\\": \\\"date\\\", \\\"required\\\": false, \\\"is_full_name\\\": false}]\")\n .build());\nSystem.out.println(result);"},{"lang":"php","label":"PHP","source":"\u003c?php\n\nrequire 'vendor/autoload.php';\n\nuse Didit\\DiditClient;\nuse Didit\\File;\n\n// Reads DIDIT_API_KEY.\n$didit = new DiditClient();\n\n$result = $didit->documentAi->analyze([\n 'document' => File::fromPath('document.pdf'),\n 'fields' => '[{\"key\": \"employer_name\", \"name\": \"Employer name\", \"instruction\": \"The employer or company issuing the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": false}, {\"key\": \"employee_name\", \"name\": \"Employee name\", \"instruction\": \"The full name of the employee as printed on the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": true}, {\"key\": \"net_pay\", \"name\": \"Net pay\", \"instruction\": \"The net amount paid to the employee for the period.\", \"type\": \"number\", \"required\": true, \"is_full_name\": false}, {\"key\": \"pay_date\", \"name\": \"Pay date\", \"instruction\": \"The payment date shown on the payslip.\", \"type\": \"date\", \"required\": false, \"is_full_name\": false}]',\n]);\nprint_r($result->toArray());"},{"lang":"ruby","label":"Ruby","source":"require \"didit\"\n\n# Reads DIDIT_API_KEY.\ndidit = Didit::Client.new\n\nresult = didit.document_ai.analyze(\n document: Pathname(\"document.pdf\"),\n fields: \"[{\\\"key\\\": \\\"employer_name\\\", \\\"name\\\": \\\"Employer name\\\", \\\"instruction\\\": \\\"The employer or company issuing the payslip.\\\", \\\"type\\\": \\\"text\\\", \\\"required\\\": true, \\\"is_full_name\\\": false}, {\\\"key\\\": \\\"employee_name\\\", \\\"name\\\": \\\"Employee name\\\", \\\"instruction\\\": \\\"The full name of the employee as printed on the payslip.\\\", \\\"type\\\": \\\"text\\\", \\\"required\\\": true, \\\"is_full_name\\\": true}, {\\\"key\\\": \\\"net_pay\\\", \\\"name\\\": \\\"Net pay\\\", \\\"instruction\\\": \\\"The net amount paid to the employee for the period.\\\", \\\"type\\\": \\\"number\\\", \\\"required\\\": true, \\\"is_full_name\\\": false}, {\\\"key\\\": \\\"pay_date\\\", \\\"name\\\": \\\"Pay date\\\", \\\"instruction\\\": \\\"The payment date shown on the payslip.\\\", \\\"type\\\": \\\"date\\\", \\\"required\\\": false, \\\"is_full_name\\\": false}]\"\n)\nputs result.to_h"},{"lang":"csharp","label":".NET","source":"using System;\nusing System.Text.Json;\nusing Didit;\n\n// Reads DIDIT_API_KEY.\nusing var client = new DiditClient();\n\nvar result = await client.DocumentAi.AnalyzeAsync(new DocumentAiAnalyzeParams\n{\n Document = FileUpload.FromPath(\"document.pdf\"),\n Fields = \"[{\\\"key\\\": \\\"employer_name\\\", \\\"name\\\": \\\"Employer name\\\", \\\"instruction\\\": \\\"The employer or company issuing the payslip.\\\", \\\"type\\\": \\\"text\\\", \\\"required\\\": true, \\\"is_full_name\\\": false}, {\\\"key\\\": \\\"employee_name\\\", \\\"name\\\": \\\"Employee name\\\", \\\"instruction\\\": \\\"The full name of the employee as printed on the payslip.\\\", \\\"type\\\": \\\"text\\\", \\\"required\\\": true, \\\"is_full_name\\\": true}, {\\\"key\\\": \\\"net_pay\\\", \\\"name\\\": \\\"Net pay\\\", \\\"instruction\\\": \\\"The net amount paid to the employee for the period.\\\", \\\"type\\\": \\\"number\\\", \\\"required\\\": true, \\\"is_full_name\\\": false}, {\\\"key\\\": \\\"pay_date\\\", \\\"name\\\": \\\"Pay date\\\", \\\"instruction\\\": \\\"The payment date shown on the payslip.\\\", \\\"type\\\": \\\"date\\\", \\\"required\\\": false, \\\"is_full_name\\\": false}]\",\n});\nConsole.WriteLine(JsonSerializer.Serialize(result));"}],"method":"post","type":"path","servers":["02beeb7f-8206-467b-a533-ab0c3e32634c"],"path":"/v3/document-ai/","baseUrlOptions":["https://verification.didit.me"],"title":"Document AI(사용자 정의 필드 추출 + 위변조 검사)","codeSamples":[{"label":"Python","lang":"python","source":"from didit import Didit\n\n# Reads DIDIT_API_KEY.\nclient = Didit()\n\nresult = client.document_ai.analyze(\n document=open(\"document.pdf\", \"rb\"),\n fields=\"[{\\\"key\\\": \\\"employer_name\\\", \\\"name\\\": \\\"Employer name\\\", \\\"instruction\\\": \\\"The employer or company issuing the payslip.\\\", \\\"type\\\": \\\"text\\\", \\\"required\\\": true, \\\"is_full_name\\\": false}, {\\\"key\\\": \\\"employee_name\\\", \\\"name\\\": \\\"Employee name\\\", \\\"instruction\\\": \\\"The full name of the employee as printed on the payslip.\\\", \\\"type\\\": \\\"text\\\", \\\"required\\\": true, \\\"is_full_name\\\": true}, {\\\"key\\\": \\\"net_pay\\\", \\\"name\\\": \\\"Net pay\\\", \\\"instruction\\\": \\\"The net amount paid to the employee for the period.\\\", \\\"type\\\": \\\"number\\\", \\\"required\\\": true, \\\"is_full_name\\\": false}, {\\\"key\\\": \\\"pay_date\\\", \\\"name\\\": \\\"Pay date\\\", \\\"instruction\\\": \\\"The payment date shown on the payslip.\\\", \\\"type\\\": \\\"date\\\", \\\"required\\\": false, \\\"is_full_name\\\": false}]\",\n)\nprint(result)"},{"label":"Node.js","lang":"javascript","source":"import Didit, { fileFromPath } from \"@didit-protocol/sdk-node\";\n\n// Reads DIDIT_API_KEY.\nconst didit = new Didit();\n\nconst result = await didit.documentAi.analyze({\n document: await fileFromPath(\"document.pdf\"),\n fields: \"[{\\\"key\\\": \\\"employer_name\\\", \\\"name\\\": \\\"Employer name\\\", \\\"instruction\\\": \\\"The employer or company issuing the payslip.\\\", \\\"type\\\": \\\"text\\\", \\\"required\\\": true, \\\"is_full_name\\\": false}, {\\\"key\\\": \\\"employee_name\\\", \\\"name\\\": \\\"Employee name\\\", \\\"instruction\\\": \\\"The full name of the employee as printed on the payslip.\\\", \\\"type\\\": \\\"text\\\", \\\"required\\\": true, \\\"is_full_name\\\": true}, {\\\"key\\\": \\\"net_pay\\\", \\\"name\\\": \\\"Net pay\\\", \\\"instruction\\\": \\\"The net amount paid to the employee for the period.\\\", \\\"type\\\": \\\"number\\\", \\\"required\\\": true, \\\"is_full_name\\\": false}, {\\\"key\\\": \\\"pay_date\\\", \\\"name\\\": \\\"Pay date\\\", \\\"instruction\\\": \\\"The payment date shown on the payslip.\\\", \\\"type\\\": \\\"date\\\", \\\"required\\\": false, \\\"is_full_name\\\": false}]\",\n});\nconsole.log(result);"},{"label":"Go","lang":"go","source":"ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.DocumentAi.Analyze(ctx, didit.DocumentAiAnalyzeParams{\n\tDocument: didit.FileFromPath(\"document.pdf\"),\n\tFields: \"[{\\\"key\\\": \\\"employer_name\\\", \\\"name\\\": \\\"Employer name\\\", \\\"instruction\\\": \\\"The employer or company issuing the payslip.\\\", \\\"type\\\": \\\"text\\\", \\\"required\\\": true, \\\"is_full_name\\\": false}, {\\\"key\\\": \\\"employee_name\\\", \\\"name\\\": \\\"Employee name\\\", \\\"instruction\\\": \\\"The full name of the employee as printed on the payslip.\\\", \\\"type\\\": \\\"text\\\", \\\"required\\\": true, \\\"is_full_name\\\": true}, {\\\"key\\\": \\\"net_pay\\\", \\\"name\\\": \\\"Net pay\\\", \\\"instruction\\\": \\\"The net amount paid to the employee for the period.\\\", \\\"type\\\": \\\"number\\\", \\\"required\\\": true, \\\"is_full_name\\\": false}, {\\\"key\\\": \\\"pay_date\\\", \\\"name\\\": \\\"Pay date\\\", \\\"instruction\\\": \\\"The payment date shown on the payslip.\\\", \\\"type\\\": \\\"date\\\", \\\"required\\\": false, \\\"is_full_name\\\": false}]\",\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)"},{"label":"Java","lang":"java","source":"import java.nio.file.Path;\nimport me.didit.Didit;\nimport me.didit.types.DocumentAiAnalyzeParams;\n\n// Reads DIDIT_API_KEY.\nDidit client = new Didit();\n\nvar result = client.documentAi().analyze(DocumentAiAnalyzeParams.builder()\n .document(Path.of(\"document.pdf\"))\n .fields(\"[{\\\"key\\\": \\\"employer_name\\\", \\\"name\\\": \\\"Employer name\\\", \\\"instruction\\\": \\\"The employer or company issuing the payslip.\\\", \\\"type\\\": \\\"text\\\", \\\"required\\\": true, \\\"is_full_name\\\": false}, {\\\"key\\\": \\\"employee_name\\\", \\\"name\\\": \\\"Employee name\\\", \\\"instruction\\\": \\\"The full name of the employee as printed on the payslip.\\\", \\\"type\\\": \\\"text\\\", \\\"required\\\": true, \\\"is_full_name\\\": true}, {\\\"key\\\": \\\"net_pay\\\", \\\"name\\\": \\\"Net pay\\\", \\\"instruction\\\": \\\"The net amount paid to the employee for the period.\\\", \\\"type\\\": \\\"number\\\", \\\"required\\\": true, \\\"is_full_name\\\": false}, {\\\"key\\\": \\\"pay_date\\\", \\\"name\\\": \\\"Pay date\\\", \\\"instruction\\\": \\\"The payment date shown on the payslip.\\\", \\\"type\\\": \\\"date\\\", \\\"required\\\": false, \\\"is_full_name\\\": false}]\")\n .build());\nSystem.out.println(result);"},{"label":"PHP","lang":"php","source":"\u003c?php\n\nrequire 'vendor/autoload.php';\n\nuse Didit\\DiditClient;\nuse Didit\\File;\n\n// Reads DIDIT_API_KEY.\n$didit = new DiditClient();\n\n$result = $didit->documentAi->analyze([\n 'document' => File::fromPath('document.pdf'),\n 'fields' => '[{\"key\": \"employer_name\", \"name\": \"Employer name\", \"instruction\": \"The employer or company issuing the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": false}, {\"key\": \"employee_name\", \"name\": \"Employee name\", \"instruction\": \"The full name of the employee as printed on the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": true}, {\"key\": \"net_pay\", \"name\": \"Net pay\", \"instruction\": \"The net amount paid to the employee for the period.\", \"type\": \"number\", \"required\": true, \"is_full_name\": false}, {\"key\": \"pay_date\", \"name\": \"Pay date\", \"instruction\": \"The payment date shown on the payslip.\", \"type\": \"date\", \"required\": false, \"is_full_name\": false}]',\n]);\nprint_r($result->toArray());"},{"label":"Ruby","lang":"ruby","source":"require \"didit\"\n\n# Reads DIDIT_API_KEY.\ndidit = Didit::Client.new\n\nresult = didit.document_ai.analyze(\n document: Pathname(\"document.pdf\"),\n fields: \"[{\\\"key\\\": \\\"employer_name\\\", \\\"name\\\": \\\"Employer name\\\", \\\"instruction\\\": \\\"The employer or company issuing the payslip.\\\", \\\"type\\\": \\\"text\\\", \\\"required\\\": true, \\\"is_full_name\\\": false}, {\\\"key\\\": \\\"employee_name\\\", \\\"name\\\": \\\"Employee name\\\", \\\"instruction\\\": \\\"The full name of the employee as printed on the payslip.\\\", \\\"type\\\": \\\"text\\\", \\\"required\\\": true, \\\"is_full_name\\\": true}, {\\\"key\\\": \\\"net_pay\\\", \\\"name\\\": \\\"Net pay\\\", \\\"instruction\\\": \\\"The net amount paid to the employee for the period.\\\", \\\"type\\\": \\\"number\\\", \\\"required\\\": true, \\\"is_full_name\\\": false}, {\\\"key\\\": \\\"pay_date\\\", \\\"name\\\": \\\"Pay date\\\", \\\"instruction\\\": \\\"The payment date shown on the payslip.\\\", \\\"type\\\": \\\"date\\\", \\\"required\\\": false, \\\"is_full_name\\\": false}]\"\n)\nputs result.to_h"},{"label":".NET","lang":"csharp","source":"using System;\nusing System.Text.Json;\nusing Didit;\n\n// Reads DIDIT_API_KEY.\nusing var client = new DiditClient();\n\nvar result = await client.DocumentAi.AnalyzeAsync(new DocumentAiAnalyzeParams\n{\n Document = FileUpload.FromPath(\"document.pdf\"),\n Fields = \"[{\\\"key\\\": \\\"employer_name\\\", \\\"name\\\": \\\"Employer name\\\", \\\"instruction\\\": \\\"The employer or company issuing the payslip.\\\", \\\"type\\\": \\\"text\\\", \\\"required\\\": true, \\\"is_full_name\\\": false}, {\\\"key\\\": \\\"employee_name\\\", \\\"name\\\": \\\"Employee name\\\", \\\"instruction\\\": \\\"The full name of the employee as printed on the payslip.\\\", \\\"type\\\": \\\"text\\\", \\\"required\\\": true, \\\"is_full_name\\\": true}, {\\\"key\\\": \\\"net_pay\\\", \\\"name\\\": \\\"Net pay\\\", \\\"instruction\\\": \\\"The net amount paid to the employee for the period.\\\", \\\"type\\\": \\\"number\\\", \\\"required\\\": true, \\\"is_full_name\\\": false}, {\\\"key\\\": \\\"pay_date\\\", \\\"name\\\": \\\"Pay date\\\", \\\"instruction\\\": \\\"The payment date shown on the payslip.\\\", \\\"type\\\": \\\"date\\\", \\\"required\\\": false, \\\"is_full_name\\\": false}]\",\n});\nConsole.WriteLine(JsonSerializer.Serialize(result));"}],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.document":"\u003cstring>","body.fields":"[{\"key\": \"employer_name\", \"name\": \"Employer name\", \"instruction\": \"The employer or company issuing the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": false}, {\"key\": \"employee_name\", \"name\": \"Employee name\", \"instruction\": \"The full name of the employee as printed on the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": true}, {\"key\": \"net_pay\", \"name\": \"Net pay\", \"instruction\": \"The net amount paid to the employee for the period.\", \"type\": \"number\", \"required\": true, \"is_full_name\": false}, {\"key\": \"pay_date\", \"name\": \"Pay date\", \"instruction\": \"The payment date shown on the payslip.\", \"type\": \"date\", \"required\": false, \"is_full_name\": false}]","body.expected_first_name":"Sophia","body.expected_last_name":"Martinez","body.expected_company_name":"\u003cstring>","body.expected_company_country":"\u003cstring>","body.document_ai_name_match_score_threshold":80,"body.document_ai_unreadable_document_action":"REVIEW","body.document_ai_missing_required_fields_action":"REVIEW","body.document_ai_document_tampering_action":"DECLINE","body.document_ai_name_mismatch_action":"NO_ACTION","body.document_ai_unsupported_file_action":"REVIEW","body.save_api_request":true,"body.vendor_data":"user-123","body.metadata":{"flow":"onboarding"}}]},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["document","fields"],"properties":{"document":{"type":"string","format":"binary","description":"판독할 문서입니다. 허용되는 확장자: `tiff`, `jpg`, `jpeg`, `png`, `pdf`, `webp`, `zip`. 최대 업로드 크기: **30 MB**(더 큰 파일은 `400`으로 거부됨). 다중 페이지 PDF가 지원됩니다(지연 시간이 길어질 수 있음). 암호화된 PDF는 `400`으로 거부됩니다. 이미지는 처리 전에 자동으로 압축됩니다.","isRequired":true,"uniqueKey":"document","typeLabel":"file"},"fields":{"type":"string","description":"**1–30**개의 필드 정의가 포함된 JSON 인코딩 배열 문자열(최대 16KB)입니다. 각 항목: `key`(필수, `^[a-z0-9_]{1,64}$`, 고유값 — `extracted_data`에서 반환되는 키), `name`(100자 이하, 메시지에 표시됨), `instruction`(500자 이하, 모델이 읽어야 하는 내용), `type`(기본값 `text` | `number` | `date`), `required`(부울, 기본값 `false`), `is_full_name`(부울, 기본값 `false`, 요청당 최대 1개). 대괄호 스타일 폼 배열, 잘못된 JSON, 중복된 키 또는 둘 이상의 `is_full_name`은 처리나 결제가 진행되기 전에 `400`을 반환합니다.","example":"[{\"key\": \"employer_name\", \"name\": \"Employer name\", \"instruction\": \"The employer or company issuing the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": false}, {\"key\": \"employee_name\", \"name\": \"Employee name\", \"instruction\": \"The full name of the employee as printed on the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": true}, {\"key\": \"net_pay\", \"name\": \"Net pay\", \"instruction\": \"The net amount paid to the employee for the period.\", \"type\": \"number\", \"required\": true, \"is_full_name\": false}, {\"key\": \"pay_date\", \"name\": \"Pay date\", \"instruction\": \"The payment date shown on the payslip.\", \"type\": \"date\", \"required\": false, \"is_full_name\": false}]","isRequired":true,"uniqueKey":"fields","typeLabel":"string"},"expected_first_name":{"type":"string","description":"문서의 이름 필드와 대조하여 검증할 이름입니다(퍼지 일치, 음차 인식). `expected_last_name`과 함께 사용해야 하며, `expected_company_name`과 결합할 수 없습니다.","example":"Sophia","uniqueKey":"expected_first_name","typeLabel":"string"},"expected_last_name":{"type":"string","description":"문서의 이름 필드와 대조하여 검증할 성으로, `name_match_score`를 위해 `expected_first_name`과 결합됩니다.","example":"Martinez","uniqueKey":"expected_last_name","typeLabel":"string"},"expected_company_name":{"type":"string","description":"문서의 이름 필드와 대조하여 확인할 기업명입니다(기업 문서용). `expected_first_name` / `expected_last_name`과 함께 사용할 수 없습니다(예시 값은 의도적으로 제공되지 않음 — 생성된 요청 샘플에는 개인 필드가 사용되므로, 기업 문서를 확인할 때는 이 필드로 교체하십시오).","uniqueKey":"expected_company_name","typeLabel":"string"},"expected_company_country":{"type":"string","description":"`expected_company_name`에 대한 기업명 정규화를 조정하는 선택적 ISO 3166-1 alpha-2 국가 코드(ASCII 2글자, 예: `FR`)입니다. `expected_company_name`과 함께만 사용됩니다.","uniqueKey":"expected_company_country","typeLabel":"string"},"document_ai_name_match_score_threshold":{"type":"integer","minimum":0,"maximum":100,"default":80,"description":"이름이 일치하는 것으로 간주하기 위한 최소 `name_match_score`(0–100)입니다. 점수가 이보다 낮으면 `DOCUMENT_AI_NAME_MISMATCH`가 추가되며, `document_ai_name_mismatch_action`의 제어를 받습니다.","example":80,"uniqueKey":"document_ai_name_match_score_threshold","typeLabel":"integer"},"document_ai_unreadable_document_action":{"type":"string","enum":["DECLINE","REVIEW","NO_ACTION"],"default":"REVIEW","description":"문서에서 어떤 필드도 읽을 수 없을 때(`DOCUMENT_AI_UNREADABLE_DOCUMENT`) 수행할 작업입니다.","uniqueKey":"document_ai_unreadable_document_action","typeLabel":"enum\u003cstring>"},"document_ai_missing_required_fields_action":{"type":"string","enum":["DECLINE","REVIEW","NO_ACTION"],"default":"REVIEW","description":"`required` 필드 중 하나 이상을 읽을 수 없을 때(`DOCUMENT_AI_MISSING_REQUIRED_FIELDS`, 해당 필드는 `additional_data.missing_fields`에 나열됨) 수행할 작업입니다.","uniqueKey":"document_ai_missing_required_fields_action","typeLabel":"enum\u003cstring>"},"document_ai_document_tampering_action":{"type":"string","enum":["DECLINE","REVIEW","NO_ACTION"],"default":"DECLINE","description":"PDF/EXIF 포렌식에서 전자 서명 후 수정, 알려진 PDF 편집기 사용, 오버레이 텍스트 조작, 의심스러운 재내보내기, 이미지 이상 현상 등 위변조가 의심될 때(`DOCUMENT_AI_SUSPECTED_MANIPULATION`) 수행할 작업입니다.","uniqueKey":"document_ai_document_tampering_action","typeLabel":"enum\u003cstring>"},"document_ai_name_mismatch_action":{"type":"string","enum":["DECLINE","REVIEW","NO_ACTION"],"default":"NO_ACTION","description":"`name_match_score`가 임계값 미만일 때(`DOCUMENT_AI_NAME_MISMATCH`) 수행할 작업입니다.","uniqueKey":"document_ai_name_mismatch_action","typeLabel":"enum\u003cstring>"},"document_ai_unsupported_file_action":{"type":"string","enum":["DECLINE","REVIEW","NO_ACTION"],"default":"REVIEW","description":"업로드된 항목이 비어 있거나 처리할 수 없는 파일일 때 수행할 작업입니다 (`DOCUMENT_AI_UNSUPPORTED_FILE`).","uniqueKey":"document_ai_unsupported_file_action","typeLabel":"enum\u003cstring>"},"save_api_request":{"type":"boolean","default":true,"description":"`true`(기본값)인 경우 호출을 API 유형 세션으로 저장합니다. Business Console에서 확인할 수 있고 반환된 `request_id`를 사용하여 `GET /v3/session/{sessionId}/decision/`을 통해 조회할 수 있으며 업로드된 문서, 추출된 값, 필드 정의 및 이름 일치 스냅샷이 저장됩니다. `false`인 경우 아무것도 저장되지 않고 `request_id`는 응답 상관관계 식별 전용의 일시적인 UUID이지만 호출에 대한 요금은 여전히 청구됩니다.","example":true,"uniqueKey":"save_api_request","typeLabel":"boolean"},"vendor_data":{"type":"string","description":"저장된 세션에 저장되고 응답에 다시 반환되는 선택적 불투명 문자열(내부 사용자 ID, 이메일, UUID 등)입니다. API 호출을 자체 기록과 연관 짓고 나중에 세션을 필터링하는 데 사용합니다.","example":"user-123","uniqueKey":"vendor_data","typeLabel":"string"},"metadata":{"type":"object","additionalProperties":true,"description":"세션과 함께 저장되고(`save_api_request=true`인 경우) 응답에 그대로 반환되는 선택적 JSON 객체입니다. multipart 요청에서는 JSON 인코딩된 문자열 필드(예: `metadata={\"flow\":\"onboarding\"}`)로 전송하십시오. 객체로 파싱됩니다.","example":{"flow":"onboarding"},"uniqueKey":"metadata","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"document":"\u003cstring>","fields":"[{\"key\": \"employer_name\", \"name\": \"Employer name\", \"instruction\": \"The employer or company issuing the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": false}, {\"key\": \"employee_name\", \"name\": \"Employee name\", \"instruction\": \"The full name of the employee as printed on the payslip.\", \"type\": \"text\", \"required\": true, \"is_full_name\": true}, {\"key\": \"net_pay\", \"name\": \"Net pay\", \"instruction\": \"The net amount paid to the employee for the period.\", \"type\": \"number\", \"required\": true, \"is_full_name\": false}, {\"key\": \"pay_date\", \"name\": \"Pay date\", \"instruction\": \"The payment date shown on the payslip.\", \"type\": \"date\", \"required\": false, \"is_full_name\": false}]","expected_first_name":"Sophia","expected_last_name":"Martinez","expected_company_name":"\u003cstring>","expected_company_country":"\u003cstring>","document_ai_name_match_score_threshold":80,"document_ai_unreadable_document_action":"REVIEW","document_ai_missing_required_fields_action":"REVIEW","document_ai_document_tampering_action":"DECLINE","document_ai_name_mismatch_action":"NO_ACTION","document_ai_unsupported_file_action":"REVIEW","save_api_request":true,"vendor_data":"user-123","metadata":{"flow":"onboarding"}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"e4f7b6c0-29bf-42a1-8f82-35050edc15b8":{"description":"문서가 처리되었습니다. `document_ai.status`는 `Approved`, `Declined` 또는 `In Review`입니다. 감지된 모든 문제는 `document_ai.warnings`에 항목별로 나열됩니다. 문제가 있는 문서라도 `200`을 반환하므로 HTTP 코드뿐만 아니라 본문도 검사해야 합니다. `save_api_request=true`인 경우 `request_id`는 저장된 세션 ID입니다.","content":{"application/json":{"examples":{"Approved":{"title":"Approved","value":{"request_id":"9d6a3b1e-2f0c-4a8e-9b7d-1c2e3f4a5b6c","document_ai":{"status":"Approved","extracted_data":{"employer_name":"Acme Payments Ltd","employee_name":"Sophia Martinez","net_pay":3120.5,"pay_date":"2026-07-31"},"detected_codes":[{"type":"CODE_128","page_number":1,"position":[[96,456],[96,616],[1012,611],[1015,456]],"x":96,"y":456,"width":919,"height":160,"page_width":1200,"page_height":1700,"raw_payload":"SU5WLTIwMjYtMDA0Mg==","parsed_payload":"INV-2026-0042"}],"fields":[{"key":"employer_name","name":"Employer name","instruction":"The employer or company issuing the payslip.","type":"text","required":true,"is_full_name":false},{"key":"employee_name","name":"Employee name","instruction":"The full name of the employee as printed on the payslip.","type":"text","required":true,"is_full_name":true},{"key":"net_pay","name":"Net pay","instruction":"The net amount paid to the employee for the period.","type":"number","required":true,"is_full_name":false},{"key":"pay_date","name":"Pay date","instruction":"The payment date shown on the payslip.","type":"date","required":false,"is_full_name":false}],"name_match_score":100,"name_on_document":"Sophia Martinez","warnings":[]},"vendor_data":"user-123","metadata":{"flow":"onboarding"},"created_at":"2026-08-19T16:40:12.318Z"}},"In Review — missing required field":{"title":"In Review — missing required field","value":{"request_id":"3f2a9c7b-5d4e-4b1a-8c6f-0e9d8c7b6a5f","document_ai":{"status":"In Review","extracted_data":{"employer_name":"Acme Payments Ltd","employee_name":"Sophia Martinez","net_pay":null,"pay_date":"2026-07-31"},"detected_codes":[],"fields":[{"key":"employer_name","name":"Employer name","instruction":"The employer or company issuing the payslip.","type":"text","required":true,"is_full_name":false},{"key":"employee_name","name":"Employee name","instruction":"The full name of the employee as printed on the payslip.","type":"text","required":true,"is_full_name":true},{"key":"net_pay","name":"Net pay","instruction":"The net amount paid to the employee for the period.","type":"number","required":true,"is_full_name":false},{"key":"pay_date","name":"Pay date","instruction":"The payment date shown on the payslip.","type":"date","required":false,"is_full_name":false}],"name_match_score":100,"name_on_document":"Sophia Martinez","warnings":[{"risk":"DOCUMENT_AI_MISSING_REQUIRED_FIELDS","feature":"DOCUMENT_AI","additional_data":{"missing_fields":["Net pay"]},"log_type":"warning","short_description":"Required fields could not be extracted","long_description":"One or more fields configured as required could not be extracted from the uploaded document."}]},"vendor_data":null,"metadata":null,"created_at":"2026-08-19T16:41:05.002Z"}},"Declined — suspected manipulation":{"title":"Declined — suspected manipulation","value":{"request_id":"7c1d2e3f-4a5b-4c6d-8e9f-0a1b2c3d4e5f","document_ai":{"status":"Declined","extracted_data":{"employer_name":"Acme Payments Ltd","employee_name":"Sophia Martinez","net_pay":3120.5,"pay_date":"2026-07-31"},"detected_codes":[],"fields":[{"key":"employer_name","name":"Employer name","instruction":"The employer or company issuing the payslip.","type":"text","required":true,"is_full_name":false},{"key":"employee_name","name":"Employee name","instruction":"The full name of the employee as printed on the payslip.","type":"text","required":true,"is_full_name":true},{"key":"net_pay","name":"Net pay","instruction":"The net amount paid to the employee for the period.","type":"number","required":true,"is_full_name":false},{"key":"pay_date","name":"Pay date","instruction":"The payment date shown on the payslip.","type":"date","required":false,"is_full_name":false}],"name_match_score":null,"name_on_document":"Sophia Martinez","warnings":[{"risk":"DOCUMENT_AI_SUSPECTED_MANIPULATION","feature":"DOCUMENT_AI","additional_data":{"detection_method":"known_editor","processed_by_known_editor":"ilovepdf"},"log_type":"error","short_description":"Suspected document manipulation","long_description":"The system detected signs of potential manipulation or editing in the uploaded document."}]},"vendor_data":null,"metadata":null,"created_at":"2026-08-19T16:42:40.771Z"}}},"schema":{"type":"object","properties":{"request_id":{"type":"string","format":"uuid","description":"`save_api_request=true`일 때 유지된 세션 ID(`GET /v3/session/{sessionId}/decision/`와 함께 사용 가능), 그렇지 않으면 임시 상관관계 UUID입니다.","uniqueKey":"request_id","typeLabel":"string\u003cuuid>"},"document_ai":{"type":"object","properties":{"status":{"type":"string","enum":["Approved","Declined","In Review"],"description":"어떤 경고도 거부나 검토로 이어지지 않는 경우 `Approved`, 하나 이상의 위험 요소가 `DECLINE`에 매핑되는 경우 `Declined`, 그 외에 하나 이상의 위험 요소가 `REVIEW`에 매핑되는 경우 `In Review`가 됩니다. `warnings` 목록에 이유가 설명되어 있습니다.","uniqueKey":"document_ai.status","typeLabel":"enum\u003cstring>"},"extracted_data":{"type":"object","additionalProperties":true,"description":"요청된 필드 키당 항목 1개입니다. 값은 필드 `type`에 따라 유형이 지정되며(`text`의 경우 문자열, `number`의 경우 숫자, `date`의 경우 `YYYY-MM-DD` 문자열), 값을 읽을 수 없는 경우 `null`입니다.","example":{"employer_name":"Acme Payments Ltd","employee_name":"Sophia Martinez","net_pay":3120.5,"pay_date":"2026-07-31"},"uniqueKey":"document_ai.extracted_data","typeLabel":"object"},"detected_codes":{"type":"array","description":"처리된 모든 페이지에서 감지된 QR 코드 및 바코드입니다. 발견되지 않으면 비어 있습니다. 위치는 식별되었으나 디코딩할 수 없는 QR 코드는 `parsed_payload: null`을 가집니다.","items":{"type":"object","required":["type","page_number","position","x","y","width","height","page_width","page_height","raw_payload","parsed_payload"],"properties":{"type":{"type":"string","description":"감지된 심볼로지(예: `QR_CODE`, `CODE_128`, `EAN_13`, `DATA_MATRIX` 또는 `PDF_417`)입니다.","isRequired":true,"uniqueKey":"document_ai.detected_codes.items.[INDEX].type","typeLabel":"string"},"page_number":{"type":"integer","minimum":1,"description":"1부터 시작하는 페이지 번호입니다.","isRequired":true,"uniqueKey":"document_ai.detected_codes.items.[INDEX].page_number","typeLabel":"integer"},"position":{"oneOf":[{"type":"array","description":"렌더링된 페이지의 픽셀 좌표로 감지된 다각형(polygon)입니다. 신뢰할 수 있는 위치를 찾을 수 없는 경우 `null`입니다.","items":{"type":"array","minItems":2,"maxItems":2,"items":{"type":"integer","uniqueKey":"document_ai.detected_codes.items.[INDEX].position.oneOf.0.items.[INDEX].items.[INDEX]","typeLabel":"integer"},"uniqueKey":"document_ai.detected_codes.items.[INDEX].position.oneOf.0.items.[INDEX]","typeLabel":"integer[]"},"isRequired":true,"uniqueKey":"document_ai.detected_codes.items.[INDEX].position.oneOf.0","typeLabel":"integer[][]"},{"type":"null","description":"렌더링된 페이지의 픽셀 좌표로 감지된 다각형(polygon)입니다. 신뢰할 수 있는 위치를 찾을 수 없는 경우 `null`입니다.","items":{"type":"array","minItems":2,"maxItems":2,"items":{"type":"integer"}},"isRequired":true,"uniqueKey":"document_ai.detected_codes.items.[INDEX].position.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"document_ai.detected_codes.items.[INDEX].position","typeLabel":"integer[][] | null"},"x":{"oneOf":[{"type":"integer","description":"렌더링된 페이지 픽셀 단위의 경계 상자 왼쪽 가장자리입니다.","isRequired":true,"uniqueKey":"document_ai.detected_codes.items.[INDEX].x.oneOf.0","typeLabel":"integer"},{"type":"null","description":"렌더링된 페이지 픽셀 단위의 경계 상자 왼쪽 가장자리입니다.","isRequired":true,"uniqueKey":"document_ai.detected_codes.items.[INDEX].x.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"document_ai.detected_codes.items.[INDEX].x","typeLabel":"integer | null"},"y":{"oneOf":[{"type":"integer","description":"렌더링된 페이지 픽셀 기준 경계 상자의 상단 가장자리입니다.","isRequired":true,"uniqueKey":"document_ai.detected_codes.items.[INDEX].y.oneOf.0","typeLabel":"integer"},{"type":"null","description":"렌더링된 페이지 픽셀 기준 경계 상자의 상단 가장자리입니다.","isRequired":true,"uniqueKey":"document_ai.detected_codes.items.[INDEX].y.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"document_ai.detected_codes.items.[INDEX].y","typeLabel":"integer | null"},"width":{"oneOf":[{"type":"integer","description":"렌더링된 페이지 픽셀 단위의 경계 상자 너비입니다.","isRequired":true,"uniqueKey":"document_ai.detected_codes.items.[INDEX].width.oneOf.0","typeLabel":"integer"},{"type":"null","description":"렌더링된 페이지 픽셀 단위의 경계 상자 너비입니다.","isRequired":true,"uniqueKey":"document_ai.detected_codes.items.[INDEX].width.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"document_ai.detected_codes.items.[INDEX].width","typeLabel":"integer | null"},"height":{"oneOf":[{"type":"integer","description":"렌더링된 페이지 픽셀 단위의 경계 상자 높이입니다.","isRequired":true,"uniqueKey":"document_ai.detected_codes.items.[INDEX].height.oneOf.0","typeLabel":"integer"},{"type":"null","description":"렌더링된 페이지 픽셀 단위의 경계 상자 높이입니다.","isRequired":true,"uniqueKey":"document_ai.detected_codes.items.[INDEX].height.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"document_ai.detected_codes.items.[INDEX].height","typeLabel":"integer | null"},"page_width":{"type":"integer","description":"렌더링된 페이지 너비(픽셀 단위)입니다.","isRequired":true,"uniqueKey":"document_ai.detected_codes.items.[INDEX].page_width","typeLabel":"integer"},"page_height":{"type":"integer","description":"렌더링된 페이지 높이(픽셀 단위)입니다.","isRequired":true,"uniqueKey":"document_ai.detected_codes.items.[INDEX].page_height","typeLabel":"integer"},"raw_payload":{"type":"string","description":"사용 가능한 경우 base64 문자열 형식의 원시 디코더 payload이며, 그렇지 않은 경우 빈 문자열입니다.","isRequired":true,"uniqueKey":"document_ai.detected_codes.items.[INDEX].raw_payload","typeLabel":"string"},"parsed_payload":{"oneOf":[{"description":"디코딩된 문자열 또는 구조화된 값입니다. 코드가 감지되었으나 디코딩할 수 없는 경우 `null`입니다.","isRequired":true,"uniqueKey":"document_ai.detected_codes.items.[INDEX].parsed_payload.oneOf.0","typeLabel":"any"},{"description":"디코딩된 문자열 또는 구조화된 값입니다. 코드가 감지되었으나 디코딩할 수 없는 경우 `null`입니다.","type":"null","isRequired":true,"uniqueKey":"document_ai.detected_codes.items.[INDEX].parsed_payload.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"document_ai.detected_codes.items.[INDEX].parsed_payload","typeLabel":"any | null"}},"uniqueKey":"document_ai.detected_codes.items.[INDEX]","typeLabel":"object"},"uniqueKey":"document_ai.detected_codes","typeLabel":"object[]"},"fields":{"type":"array","description":"이 추출에 사용된 정규화된 필드 정의이며, 그대로 반환됩니다(`save_api_request=true`인 경우 세션과 함께 저장되기도 함).","items":{"type":"object","properties":{"key":{"type":"string","uniqueKey":"document_ai.fields.items.[INDEX].key","typeLabel":"string"},"name":{"type":"string","uniqueKey":"document_ai.fields.items.[INDEX].name","typeLabel":"string"},"instruction":{"type":"string","uniqueKey":"document_ai.fields.items.[INDEX].instruction","typeLabel":"string"},"type":{"type":"string","enum":["text","number","date"],"uniqueKey":"document_ai.fields.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"required":{"type":"boolean","uniqueKey":"document_ai.fields.items.[INDEX].required","typeLabel":"boolean"},"is_full_name":{"type":"boolean","uniqueKey":"document_ai.fields.items.[INDEX].is_full_name","typeLabel":"boolean"}},"uniqueKey":"document_ai.fields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"document_ai.fields","typeLabel":"object[]"},"name_match_score":{"oneOf":[{"type":"number","minimum":0,"maximum":100,"description":"`name_on_document`와 예상되는 개인/기업 이름 간의 퍼지 유사도(0–100)입니다. 이름 값과 예상 이름이 모두 존재할 때 일치 **및** 불일치 시 항상 반환되며, 그렇지 않은 경우 `null`입니다.","example":96,"uniqueKey":"document_ai.name_match_score.oneOf.0","typeLabel":"number"},{"type":"null","minimum":0,"maximum":100,"description":"`name_on_document`와 예상되는 개인/기업 이름 간의 퍼지 유사도(0–100)입니다. 이름 값과 예상 이름이 모두 존재할 때 일치 **및** 불일치 시 항상 반환되며, 그렇지 않은 경우 `null`입니다.","example":96,"uniqueKey":"document_ai.name_match_score.oneOf.1","typeLabel":"null"}],"uniqueKey":"document_ai.name_match_score","typeLabel":"number | null"},"name_on_document":{"oneOf":[{"type":"string","description":"예상 이름과 비교된 문서에서 가져온 이름 값(`is_full_name` 필드 또는 이름과 유사한 첫 번째 텍스트 필드)입니다. 사용할 수 있는 이름 값이 없는 경우 `null`입니다.","example":"Sophia Martinez","uniqueKey":"document_ai.name_on_document.oneOf.0","typeLabel":"string"},{"type":"null","description":"예상 이름과 비교된 문서에서 가져온 이름 값(`is_full_name` 필드 또는 이름과 유사한 첫 번째 텍스트 필드)입니다. 사용할 수 있는 이름 값이 없는 경우 `null`입니다.","example":"Sophia Martinez","uniqueKey":"document_ai.name_on_document.oneOf.1","typeLabel":"null"}],"uniqueKey":"document_ai.name_on_document","typeLabel":"string | null"},"warnings":{"type":"array","description":"문제없이 승인된 경우 비어 있습니다. 각 항목은 감지된 하나의 위험을 설명합니다. `log_type: \"error\"`인 항목은 `status`를 `Declined`로 설정하고, `log_type: \"warning\"`인 항목은 `In Review`로 설정합니다.","items":{"type":"object","properties":{"risk":{"type":"string","enum":["DOCUMENT_AI_UNREADABLE_DOCUMENT","DOCUMENT_AI_MISSING_REQUIRED_FIELDS","DOCUMENT_AI_SUSPECTED_MANIPULATION","DOCUMENT_AI_NAME_MISMATCH","DOCUMENT_AI_UNSUPPORTED_FILE"],"description":"기계 판독 가능한 위험 코드입니다. 각각은 일치하는 `document_ai_*_action` 요청 옵션에 의해 제어됩니다.","example":"DOCUMENT_AI_MISSING_REQUIRED_FIELDS","uniqueKey":"document_ai.warnings.items.[INDEX].risk","typeLabel":"enum\u003cstring>"},"feature":{"type":"string","enum":["DOCUMENT_AI"],"description":"경고를 발생시킨 기능입니다. 이 endpoint에서는 항상 `DOCUMENT_AI`입니다.","uniqueKey":"document_ai.warnings.items.[INDEX].feature","typeLabel":"enum\u003cstring>"},"additional_data":{"oneOf":[{"type":"object","additionalProperties":true,"description":"위험에 대한 추가 컨텍스트입니다. 필수 필드가 누락된 경우 `{\"missing_fields\": [\"Net pay\"]}`, 이름 불일치의 경우 `{\"name_on_document\", \"score\", \"threshold\"}`, 위조 의심의 경우 포렌식 결과(`detection_method`, 생성자/편집자 세부 정보)가 포함됩니다. 추가할 내용이 없는 경우 `null`입니다.","example":{"missing_fields":["Net pay"]},"uniqueKey":"document_ai.warnings.items.[INDEX].additional_data.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"description":"위험에 대한 추가 컨텍스트입니다. 필수 필드가 누락된 경우 `{\"missing_fields\": [\"Net pay\"]}`, 이름 불일치의 경우 `{\"name_on_document\", \"score\", \"threshold\"}`, 위조 의심의 경우 포렌식 결과(`detection_method`, 생성자/편집자 세부 정보)가 포함됩니다. 추가할 내용이 없는 경우 `null`입니다.","example":{"missing_fields":["Net pay"]},"uniqueKey":"document_ai.warnings.items.[INDEX].additional_data.oneOf.1","typeLabel":"null"}],"uniqueKey":"document_ai.warnings.items.[INDEX].additional_data","typeLabel":"object | null"},"log_type":{"type":"string","enum":["error","warning","information"],"description":"구성된 작업에서 파생된 심각도: `error`(DECLINE), `warning`(REVIEW), `information`(NO_ACTION).","uniqueKey":"document_ai.warnings.items.[INDEX].log_type","typeLabel":"enum\u003cstring>"},"short_description":{"type":"string","description":"사람이 읽을 수 있는 한 줄의 위험 요약입니다.","example":"Required fields could not be extracted","uniqueKey":"document_ai.warnings.items.[INDEX].short_description","typeLabel":"string"},"long_description":{"type":"string","description":"해당하는 경우 `additional_data`가 삽입된 사람이 읽기 쉬운 설명입니다.","uniqueKey":"document_ai.warnings.items.[INDEX].long_description","typeLabel":"string"}},"uniqueKey":"document_ai.warnings.items.[INDEX]","typeLabel":"object"},"uniqueKey":"document_ai.warnings","typeLabel":"object[]"}},"uniqueKey":"document_ai","typeLabel":"object"},"vendor_data":{"oneOf":[{"type":"string","description":"전송한 `vendor_data`의 에코 값 또는 `null`입니다.","uniqueKey":"vendor_data.oneOf.0","typeLabel":"string"},{"type":"null","description":"전송한 `vendor_data`의 에코 값 또는 `null`입니다.","uniqueKey":"vendor_data.oneOf.1","typeLabel":"null"}],"uniqueKey":"vendor_data","typeLabel":"string | null"},"metadata":{"oneOf":[{"type":"object","additionalProperties":true,"description":"전송한 `metadata` 객체의 에코 값 또는 `null`입니다.","uniqueKey":"metadata.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"description":"전송한 `metadata` 객체의 에코 값 또는 `null`입니다.","uniqueKey":"metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"metadata","typeLabel":"object | null"},"created_at":{"type":"string","format":"date-time","description":"요청이 처리된 시점(UTC, ISO 8601).","uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"exampleType":"examples"},"60d6fe5f-9916-44a1-8ce2-faddf044382f":{"description":"검증 또는 처리 오류입니다. 필드 수준의 문제는 DRF의 표준 엔벨로프(문제가 발생한 필드당 하나의 메시지 배열)를 반환합니다. 암호화되었거나 읽을 수 없는 문서 및 추출 실패는 `{\"error\": ...}`를 반환합니다.","content":{"application/json":{"examples":{"Missing document":{"title":"Missing document","value":{"document":["No file was submitted."]}},"Invalid fields payload":{"title":"Invalid fields payload","value":{"fields":["fields must be a valid JSON array string."]}},"Duplicate field keys":{"title":"Duplicate field keys","value":{"fields":["Every fields item must have a unique key."]}},"Conflicting expectations":{"title":"Conflicting expectations","value":{"non_field_errors":["Provide either person expected-name fields or expected_company_name, not both."]}},"Invalid metadata":{"title":"Invalid metadata","value":{"metadata":["Metadata must be a JSON object."]}},"Oversized vendor_data":{"title":"Oversized vendor_data","value":{"vendor_data":["vendor_data is too long (maximum 2000 bytes)."]}},"Encrypted PDF":{"title":"Encrypted PDF","value":{"error":"The PDF is encrypted. Please upload a decrypted PDF or a photo instead."}},"Extraction failed":{"title":"Extraction failed","value":{"error":["Error extracting Document AI information"]}}},"schema":{"type":"object","additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"exampleType":"examples"},"87f1f38e-1da3-49f5-99ce-71e86ab8fc74":{"description":"권한이 거부되었습니다. `x-api-key` 헤더가 누락되었거나 호출한 조직의 잔액이 호출 비용을 충당할 수 없을 때 반환됩니다. 잘못되었거나 취소되었거나 만료된 키는 `401`을 반환합니다. 키가 누락된 경우 `{\"detail\": ...}`과 함께 `403`을 반환하고, 잘못되었거나 취소되었거나 만료된 키는 `401`을 반환합니다. 크레딧이 부족한 경우, 그리고 요금표에 Document AI API 항목이 없는 계약 청구 조직의 경우 어떠한 문서 처리도 진행되기 전에 `{\"error\": ...}`과 함께 `403`을 반환합니다.","content":{"application/json":{"examples":{"Missing or invalid API key":{"title":"Missing or invalid API key","value":{"detail":"You do not have permission to perform this action."}},"Not enough credits":{"title":"Not enough credits","value":{"error":"You don't have enough credits to perform this request. Please top up at https://business.didit.me"}},"Contract rate missing":{"title":"Contract rate missing","value":{"error":"Document AI API is not included in your contract rate card. Contact support@didit.me to enable it."}}},"schema":{"type":"object","properties":{"detail":{"type":"string","uniqueKey":"detail","typeLabel":"string"},"error":{"type":"string","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"exampleType":"examples"},"9a0f9bd3-9087-432e-92e3-c4cbdbf12b2f":{"description":"속도 제한을 초과했습니다. POST/PATCH/DELETE endpoint는 API 키당 분당 300회의 쓰기 요청 한도를 공유합니다(거래 생성 및 이벤트 수집은 별도로 600회 한도 적용). 응답에는 `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`, `Retry-After` 헤더가 포함됩니다.","content":{"application/json":{"examples":{"Write rate limit exceeded":{"title":"Write rate limit exceeded","value":{"detail":"Write request rate limit exceeded. You can make up to 300 requests per minute."}}},"schema":{"type":"object","properties":{"detail":{"type":"string","uniqueKey":"detail","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"exampleType":"examples"},"7b850e16-d978-4bfc-b5e1-c8957aacf212":{"description":"현재 너무 많은 문서가 처리 중이므로 이 업로드가 처리되지 않았습니다. 아무것도 저장되지 않았으며 시도 횟수도 사용되지 않았습니다. `Retry-After`의 시간(초)이 지난 후 동일한 파일을 다시 전송하세요. 메시지 텍스트가 아닌 `code`를 기준으로 분기하세요.","headers":{"Retry-After":{"description":"동일한 요청을 다시 전송하기 전에 대기해야 하는 시간(초)입니다.","schema":{"type":"integer","example":10}}},"content":{"application/json":{"schema":{"type":"object","required":["detail","code"],"properties":{"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"code":{"type":"string","enum":["document_processing_busy"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"example":{"detail":"We are busy processing documents. Please try again in a moment.","code":"document_processing_busy"},"examples":{"Example":{"title":"Example","value":{"detail":"We are busy processing documents. Please try again in a moment.","code":"document_processing_busy"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"69720626-394d-4f9a-9d83-e76a1f94405d":{"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 를 참고하십시오.","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"02beeb7f-8206-467b-a533-ab0c3e32634c":{"url":"https://verification.didit.me"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"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 를 참고하십시오.","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"x-api-key","type":"string","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 를 참고하십시오.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"x-api-key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"ko/openapi-25.json"},"subdomain":"didit-0f962782","siteName":"Didit Docs","title":"문서 AI API: 맞춤형 문서 데이터 추출 - Didit Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/standalone-apis/document-ai","matchLevel":1},"es":{"href":"/es/standalone-apis/document-ai","matchLevel":1},"pt-BR":{"href":"/pt-br/standalone-apis/document-ai","matchLevel":1},"ja":{"href":"/ja/standalone-apis/document-ai","matchLevel":1},"de":{"href":"/de/standalone-apis/document-ai","matchLevel":1},"fr":{"href":"/fr/standalone-apis/document-ai","matchLevel":1},"it":{"href":"/it/standalone-apis/document-ai","matchLevel":1},"pt":{"href":"/pt/standalone-apis/document-ai","matchLevel":1},"ca":{"href":"/ca/standalone-apis/document-ai","matchLevel":1},"id":{"href":"/id/standalone-apis/document-ai","matchLevel":1},"ru":{"href":"/ru/standalone-apis/document-ai","matchLevel":1},"ko":{"href":"/ko/standalone-apis/document-ai","matchLevel":0},"zh":{"href":"/zh/standalone-apis/document-ai","matchLevel":1},"ar":{"href":"/ar/standalone-apis/document-ai","matchLevel":1},"hi":{"href":"/hi/standalone-apis/document-ai","matchLevel":1}}},"lastModified":"2026-11-07T17:37:08.776Z","gitLastModified":"2026-11-07T17:24:04.000Z","originalFileLocation":"ko/standalone-apis/document-ai.mdx","locale":"ko"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"POST /v3/document-ai/로 PDF나 이미지에서 정의한 필드를 서버 간 방식으로 추출하며, 이름 대조와 위변조 검사를 지원합니다. Didit 기준 문서당 $0.20.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Didit Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/didit-0f962782/h7Er2opLBVoQwrdf/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/didit-0f962782/h7Er2opLBVoQwrdf/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/didit-0f962782/h7Er2opLBVoQwrdf/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/didit-0f962782/h7Er2opLBVoQwrdf/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/didit-0f962782/h7Er2opLBVoQwrdf/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/didit-0f962782/h7Er2opLBVoQwrdf/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/didit-0f962782/h7Er2opLBVoQwrdf/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/didit-0f962782/h7Er2opLBVoQwrdf/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/didit-0f962782/h7Er2opLBVoQwrdf/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"문서 AI API: 맞춤형 문서 데이터 추출 - Didit Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"POST /v3/document-ai/로 PDF나 이미지에서 정의한 필드를 서버 간 방식으로 추출하며, 이름 대조와 위변조 검사를 지원합니다. Didit 기준 문서당 $0.20.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Didit Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.didit.me/ko/standalone-apis/document-ai\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://didit-0f962782.mintlify.site/_mintlify/api/og/v2?division=%EB%AC%B8%EC%84%9C+AI\u0026amp;title=%EB%AC%B8%EC%84%9C+AI+API%3A+%EB%A7%9E%EC%B6%A4%ED%98%95+%EB%AC%B8%EC%84%9C+%EB%8D%B0%EC%9D%B4%ED%84%B0+%EC%B6%94%EC%B6%9C\u0026amp;description=POST+%2Fv3%2Fdocument-ai%2F%EB%A1%9C+PDF%EB%82%98+%EC%9D%B4%EB%AF%B8%EC%A7%80%EC%97%90%EC%84%9C+%EC%A0%95%EC%9D%98%ED%95%9C+%ED%95%84%EB%93%9C%EB%A5%BC+%EC%84%9C%EB%B2%84+%EA%B0%84+%EB%B0%A9%EC%8B%9D%EC%9C%BC%EB%A1%9C+%EC%B6%94%EC%B6%9C%ED%95%98%EB%A9%B0%2C+%EC%9D%B4%EB%A6%84+%EB%8C%80%EC%A1%B0%EC%99%80+%EC%9C%84%EB%B3%80%EC%A1%B0+%EA%B2%80%EC%82%AC%EB%A5%BC+%EC%A7%80%EC%9B%90%ED%95%A9%EB%8B%88%EB%8B%A4.+Didit+%EA%B8%B0%EC%A4%80+%EB%AC%B8%EC%84%9C%EB%8B%B9+%240.20.\u0026amp;theme=f6d5c5eb819d99f700ee852a\u0026amp;signature=f12fa958c10a0a11cad5aa55678a33ca346d451698f939a047a55bbc16806b25\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"문서 AI API: 맞춤형 문서 데이터 추출 - Didit Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"POST /v3/document-ai/로 PDF나 이미지에서 정의한 필드를 서버 간 방식으로 추출하며, 이름 대조와 위변조 검사를 지원합니다. Didit 기준 문서당 $0.20.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://didit-0f962782.mintlify.site/_mintlify/api/og/v2?division=%EB%AC%B8%EC%84%9C+AI\u0026amp;title=%EB%AC%B8%EC%84%9C+AI+API%3A+%EB%A7%9E%EC%B6%A4%ED%98%95+%EB%AC%B8%EC%84%9C+%EB%8D%B0%EC%9D%B4%ED%84%B0+%EC%B6%94%EC%B6%9C\u0026amp;description=POST+%2Fv3%2Fdocument-ai%2F%EB%A1%9C+PDF%EB%82%98+%EC%9D%B4%EB%AF%B8%EC%A7%80%EC%97%90%EC%84%9C+%EC%A0%95%EC%9D%98%ED%95%9C+%ED%95%84%EB%93%9C%EB%A5%BC+%EC%84%9C%EB%B2%84+%EA%B0%84+%EB%B0%A9%EC%8B%9D%EC%9C%BC%EB%A1%9C+%EC%B6%94%EC%B6%9C%ED%95%98%EB%A9%B0%2C+%EC%9D%B4%EB%A6%84+%EB%8C%80%EC%A1%B0%EC%99%80+%EC%9C%84%EB%B3%80%EC%A1%B0+%EA%B2%80%EC%82%AC%EB%A5%BC+%EC%A7%80%EC%9B%90%ED%95%A9%EB%8B%88%EB%8B%A4.+Didit+%EA%B8%B0%EC%A4%80+%EB%AC%B8%EC%84%9C%EB%8B%B9+%240.20.\u0026amp;theme=f6d5c5eb819d99f700ee852a\u0026amp;signature=f12fa958c10a0a11cad5aa55678a33ca346d451698f939a047a55bbc16806b25\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/didit-0f962782/h7Er2opLBVoQwrdf/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Didit Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2567FF\">\u003cmeta data-mint-head name=\"theme-color\" content=\"#2567FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.didit.me/ko/standalone-apis/document-ai\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ko/standalone-apis/document-ai.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.didit.me/ko/standalone-apis/document-ai\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.didit.me/standalone-apis/document-ai\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.didit.me/es/standalone-apis/document-ai\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt-BR\" href=\"https://docs.didit.me/pt-br/standalone-apis/document-ai\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ja\" href=\"https://docs.didit.me/ja/standalone-apis/document-ai\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://docs.didit.me/de/standalone-apis/document-ai\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://docs.didit.me/fr/standalone-apis/document-ai\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"it\" href=\"https://docs.didit.me/it/standalone-apis/document-ai\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt\" href=\"https://docs.didit.me/pt/standalone-apis/document-ai\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ca\" href=\"https://docs.didit.me/ca/standalone-apis/document-ai\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"id\" href=\"https://docs.didit.me/id/standalone-apis/document-ai\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ru\" href=\"https://docs.didit.me/ru/standalone-apis/document-ai\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.didit.me/zh/standalone-apis/document-ai\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ar\" href=\"https://docs.didit.me/ar/standalone-apis/document-ai\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"hi\" href=\"https://docs.didit.me/hi/standalone-apis/document-ai\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.didit.me/standalone-apis/document-ai\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://didit.me/#organization\",\"name\":\"Didit\",\"legalName\":\"Didit Protocol\",\"url\":\"https://didit.me\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://didit.me/logos/primary-horizontal-light.png\"},\"sameAs\":[\"https://www.linkedin.com/company/91001155\",\"https://www.youtube.com/@getdidit\",\"https://github.com/didit-protocol\",\"https://x.com/didit\"]},{\"@type\":\"WebSite\",\"@id\":\"https://docs.didit.me#website\",\"name\":\"Didit Docs\",\"url\":\"https://docs.didit.me\",\"publisher\":{\"@id\":\"https://didit.me/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.didit.me/ko/standalone-apis/document-ai#webpage\",\"url\":\"https://docs.didit.me/ko/standalone-apis/document-ai\",\"name\":\"문서 AI API: 맞춤형 문서 데이터 추출\",\"description\":\"POST /v3/document-ai/로 PDF나 이미지에서 정의한 필드를 서버 간 방식으로 추출하며, 이름 대조와 위변조 검사를 지원합니다. Didit 기준 문서당 $0.20.\",\"dateModified\":\"2026-11-07T17:24:04.000Z\",\"isPartOf\":{\"@id\":\"https://docs.didit.me#website\"},\"breadcrumb\":{\"@id\":\"https://docs.didit.me/ko/standalone-apis/document-ai#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.didit.me/ko/standalone-apis/document-ai#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Didit Docs\",\"item\":\"https://docs.didit.me\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"문서 AI API: 맞춤형 문서 데이터 추출\",\"item\":\"https://docs.didit.me/ko/standalone-apis/document-ai\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.didit.me/ko/standalone-apis/document-ai#apireference\",\"headline\":\"문서 AI API: 맞춤형 문서 데이터 추출\",\"name\":\"문서 AI API: 맞춤형 문서 데이터 추출\",\"description\":\"POST /v3/document-ai/로 PDF나 이미지에서 정의한 필드를 서버 간 방식으로 추출하며, 이름 대조와 위변조 검사를 지원합니다. Didit 기준 문서당 $0.20.\",\"url\":\"https://docs.didit.me/ko/standalone-apis/document-ai\",\"mainEntityOfPage\":{\"@id\":\"https://docs.didit.me/ko/standalone-apis/document-ai#webpage\"},\"dateModified\":\"2026-11-07T17:24:04.000Z\",\"keywords\":\"문서 AI API, 문서 데이터 추출 API, 맞춤형 문서 OCR API, 자금 증명 API, 급여명세서 추출 API, 은행 거래내역 OCR, KYC 문서 추출, 문서 위변조 탐지, Didit API\",\"publisher\":{\"@id\":\"https://didit.me/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.didit.me#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Didit Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Didit Docs","nav":{"global":null,"languages":[{"language":"en","pages":[{"title":"en","href":"/standalone-apis/document-ai"}]},{"language":"es","navbar":{"links":[{"icon":"comment-dots","href":"https://help.didit.me","label":"Soporte"},{"icon":"signal","href":"https://status.didit.me","label":"Estado"}],"primary":{"type":"button","label":"Iniciar sesión","href":"https://business.didit.me"}},"pages":[{"title":"es","href":"/es/standalone-apis/document-ai"}]},{"language":"pt-BR","navbar":{"links":[{"icon":"comment-dots","href":"https://help.didit.me","label":"Suporte"},{"icon":"signal","href":"https://status.didit.me","label":"Status"}],"primary":{"type":"button","label":"Entrar","href":"https://business.didit.me"}},"pages":[{"title":"pt-BR","href":"/pt-br/standalone-apis/document-ai"}]},{"language":"ja","navbar":{"links":[{"icon":"comment-dots","href":"https://help.didit.me","label":"サポート"},{"icon":"signal","href":"https://status.didit.me","label":"ステータス"}],"primary":{"type":"button","label":"サインイン","href":"https://business.didit.me"}},"pages":[{"title":"ja","href":"/ja/standalone-apis/document-ai"}]},{"language":"de","navbar":{"links":[{"icon":"comment-dots","href":"https://help.didit.me","label":"Support"},{"icon":"signal","href":"https://status.didit.me","label":"Status"}],"primary":{"type":"button","label":"Anmelden","href":"https://business.didit.me"}},"pages":[{"title":"de","href":"/de/standalone-apis/document-ai"}]},{"language":"fr","navbar":{"links":[{"icon":"comment-dots","href":"https://help.didit.me","label":"Assistance"},{"icon":"signal","href":"https://status.didit.me","label":"Statut"}],"primary":{"type":"button","label":"Se connecter","href":"https://business.didit.me"}},"pages":[{"title":"fr","href":"/fr/standalone-apis/document-ai"}]},{"language":"it","navbar":{"links":[{"icon":"comment-dots","href":"https://help.didit.me","label":"Supporto"},{"icon":"signal","href":"https://status.didit.me","label":"Stato"}],"primary":{"type":"button","label":"Accedi","href":"https://business.didit.me"}},"pages":[{"title":"it","href":"/it/standalone-apis/document-ai"}]},{"language":"pt","navbar":{"links":[{"icon":"comment-dots","href":"https://help.didit.me","label":"Suporte"},{"icon":"signal","href":"https://status.didit.me","label":"Estado"}],"primary":{"type":"button","label":"Iniciar sessão","href":"https://business.didit.me"}},"pages":[{"title":"pt","href":"/pt/standalone-apis/document-ai"}]},{"language":"ca","navbar":{"links":[{"icon":"comment-dots","href":"https://help.didit.me","label":"Suport"},{"icon":"signal","href":"https://status.didit.me","label":"Estat"}],"primary":{"type":"button","label":"Inicia la sessió","href":"https://business.didit.me"}},"pages":[{"title":"ca","href":"/ca/standalone-apis/document-ai"}]},{"language":"id","navbar":{"links":[{"icon":"comment-dots","href":"https://help.didit.me","label":"Dukungan"},{"icon":"signal","href":"https://status.didit.me","label":"Status"}],"primary":{"type":"button","label":"Masuk","href":"https://business.didit.me"}},"pages":[{"title":"id","href":"/id/standalone-apis/document-ai"}]},{"language":"ru","navbar":{"links":[{"icon":"comment-dots","href":"https://help.didit.me","label":"Поддержка"},{"icon":"signal","href":"https://status.didit.me","label":"Статус"}],"primary":{"type":"button","label":"Вход","href":"https://business.didit.me"}},"pages":[{"title":"ru","href":"/ru/standalone-apis/document-ai"}]},{"language":"ko","navbar":{"links":[{"icon":"comment-dots","href":"https://help.didit.me","label":"지원"},{"icon":"signal","href":"https://status.didit.me","label":"상태"}],"primary":{"type":"button","label":"로그인","href":"https://business.didit.me"}},"tabs":[{"tab":"시작하기","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/rocket.svg","pages":[{"title":"시작하기","href":"/ko"}]},{"tab":"연동 / SDK","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/code.svg","pages":[{"title":"연동 / SDK","href":"/ko/integration/sdks"}]},{"tab":"API 레퍼런스","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/code.svg","groups":[{"group":"개요","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/overview.svg","pages":[{"title":"Didit API 레퍼런스: 신원 인증 REST API","sidebarTitle":"API 레퍼런스","href":"/ko/api-reference/overview"},{"title":"헬스체크 API: 공개 라이브니스 프로브","sidebarTitle":"헬스체크","openapi":"ko/openapi-healthcheck.json GET /system/healthcheck","href":"/ko/api-reference/healthcheck"},{"title":"서비스 상태 API: Didit 공개 상태 피드","sidebarTitle":"서비스 상태","openapi":"ko/openapi-25.json GET /v3/status/","href":"/ko/api-reference/service-status"},{"title":"은행 인증 가격 API: 공개 가격 피드","sidebarTitle":"은행 인증 가격","openapi":"ko/openapi-25.json GET /v3/organization/bank-verification-pricing/","href":"/ko/api-reference/bank-verification-pricing"}]},{"group":"사용자 인증 및 기업 확인","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/user-verifications.svg","pages":[{"title":"신원 인증 세션 API: KYC·KYB 통합 인증","sidebarTitle":"개요","href":"/ko/sessions-api/overview"},{"title":"세션 생성 API: KYC 또는 KYB 인증 시작","sidebarTitle":"세션 생성","openapi":"ko/openapi-25.json POST /v3/session/","href":"/ko/sessions-api/create-session"},{"title":"다른 제공업체 데이터 가져오기","openapi":"ko/openapi-25.json POST /v3/session/imports/","href":"/ko/sessions-api/import-verifications"},{"title":"세션 조회 API: KYC·KYB 결정 데이터","sidebarTitle":"세션 조회","openapi":"ko/openapi-25.json GET /v3/session/{sessionId}/decision/","href":"/ko/sessions-api/retrieve-session"},{"title":"세션 목록 API: KYC·KYB 세션 필터링","sidebarTitle":"세션 목록 조회","openapi":"ko/openapi-25.json GET /v3/sessions/","href":"/ko/sessions-api/list-sessions"},{"title":"세션 상태 업데이트 API: 승인 및 거부","sidebarTitle":"세션 상태 업데이트","openapi":"ko/openapi-25.json PATCH /v3/session/{sessionId}/update-status/","href":"/ko/sessions-api/update-status"},{"title":"재제출 이메일 미리보기","openapi":"ko/openapi-25.json POST /v3/session/{sessionId}/resubmission-preview/","href":"/ko/sessions-api/preview-resubmission"},{"title":"결정 이메일 미리보기 API: 승인 및 거부 이메일","sidebarTitle":"결정 이메일 미리보기","openapi":"ko/openapi-25.json POST /v3/session/{sessionId}/decision-email-preview/","href":"/ko/sessions-api/preview-decision-email"},{"title":"기능 상태 업데이트 API: 단일 단계 승인/거부","sidebarTitle":"기능 상태 업데이트","openapi":"ko/openapi-25.json PATCH /v3/session/{sessionId}/features/{nodeId}/update-status/","href":"/ko/sessions-api/update-feature-status"},{"title":"세션 단계 상태 재정의 목록 API: 단계 상태 이력","sidebarTitle":"단계 상태 재정의 목록","openapi":"ko/openapi-25.json GET /v3/session/{sessionId}/features/overrides/","href":"/ko/sessions-api/list-feature-overrides"},{"title":"기능 오버라이드 취소 API: 대기 중인 단계 오버라이드 삭제","sidebarTitle":"기능 오버라이드 취소","openapi":"ko/openapi-25.json POST /v3/session/{sessionId}/features/overrides/{overrideId}/cancel/","href":"/ko/sessions-api/cancel-feature-override"},{"title":"AML 히트 상태 업데이트 API: 일치 확인 및 오탐 처리","sidebarTitle":"AML 히트 상태 업데이트","openapi":"ko/openapi-25.json PATCH /v3/session/{sessionId}/update-aml-hit-status/","href":"/ko/sessions-api/update-aml-hit-status"},{"title":"세션 데이터 업데이트 API: KYC 및 KYB 필드 수정","sidebarTitle":"세션 데이터 업데이트","href":"/ko/sessions-api/update-data"},{"title":"AML 검사 상태 업데이트 API","sidebarTitle":"AML 검사 상태 업데이트","openapi":"ko/openapi-25.json PATCH /v3/session/{sessionId}/update-aml-status/","href":"/ko/sessions-api/update-aml-status"},{"title":"Document AI 데이터 업데이트 API","sidebarTitle":"Document AI 데이터 업데이트","openapi":"ko/openapi-25.json PATCH /v3/document-ai/{sessionId}/documents/{documentUuid}/","href":"/ko/sessions-api/update-document-ai-data"},{"title":"주요 인물 KYC 세션 재생성 API","sidebarTitle":"주요 인물 KYC 세션 재생성","openapi":"ko/openapi-25.json POST /v3/session/{sessionId}/kyb/parties/{partyUuid}/regenerate/","href":"/ko/sessions-api/regenerate-kyb-party"},{"title":"KYB 문서 업로드 API","sidebarTitle":"KYB 문서 업로드","openapi":"ko/openapi-25.json POST /v3/session/{sessionId}/kyb/documents/","href":"/ko/sessions-api/kyb-upload-documents"},{"title":"KYB 추출 당사자 조회 API","sidebarTitle":"KYB 추출 당사자 조회","openapi":"ko/openapi-25.json GET /v3/session/{sessionId}/kyb/extracted-parties/","href":"/ko/sessions-api/kyb-extracted-parties"},{"title":"KYB 주요 인물 초안 목록 조회 API","sidebarTitle":"KYB 주요 인물 초안 조회","openapi":"ko/openapi-25.json GET /v3/session/{sessionId}/kyb/parties/drafts/","href":"/ko/sessions-api/kyb-list-party-drafts"},{"title":"KYB 주요 인물 초안 생성 API","sidebarTitle":"KYB 주요 인물 초안 생성","openapi":"ko/openapi-25.json POST /v3/session/{sessionId}/kyb/parties/drafts/","href":"/ko/sessions-api/kyb-create-party-draft"},{"title":"KYB 당사자 초안 수정 API","sidebarTitle":"KYB 당사자 초안 수정","openapi":"ko/openapi-25.json PATCH /v3/session/{sessionId}/kyb/parties/drafts/{draftId}/","href":"/ko/sessions-api/kyb-update-party-draft"},{"title":"KYB 주요 인물 초안 삭제 API","sidebarTitle":"KYB 주요 인물 초안 삭제","openapi":"ko/openapi-25.json DELETE /v3/session/{sessionId}/kyb/parties/drafts/{draftId}/","href":"/ko/sessions-api/kyb-delete-party-draft"},{"title":"KYB 주요 인물 제출 API","sidebarTitle":"KYB 주요 인물 제출","openapi":"ko/openapi-25.json POST /v3/session/{sessionId}/kyb/parties/submit/","href":"/ko/sessions-api/kyb-submit-parties"},{"title":"세션에 이미지 추가 API","sidebarTitle":"세션에 이미지 추가","openapi":"ko/openapi-25.json PATCH /v3/session/{sessionId}/add-images/","href":"/ko/sessions-api/add-images"},{"title":"세션 삭제 API: GDPR 잊힐 권리","sidebarTitle":"세션 삭제","openapi":"ko/openapi-25.json DELETE /v3/session/{sessionId}/delete/","href":"/ko/sessions-api/delete-session"},{"title":"PDF 생성 API: KYC·KYB 컴플라이언스 보고서","sidebarTitle":"PDF 생성","openapi":"ko/openapi-25.json GET /v3/session/{sessionId}/generate-pdf/","href":"/ko/sessions-api/generate-pdf"},{"title":"세션 파일 내보내기 API: 모든 파일을 ZIP 하나로 다운로드","sidebarTitle":"파일 내보내기","openapi":"ko/openapi-25.json POST /v3/session/{sessionId}/files-export/","href":"/ko/sessions-api/export-files"},{"title":"세션 파일 내보내기 조회 API: 상태 및 다운로드 링크","sidebarTitle":"파일 내보내기 조회","openapi":"ko/openapi-25.json GET /v3/session/{sessionId}/files-export/{exportId}/","href":"/ko/sessions-api/get-files-export"},{"group":"전자 서명","pages":[{"title":"서명된 문서 다운로드 API: 서명된 PDF","sidebarTitle":"서명된 문서 다운로드","openapi":"ko/openapi-25.json GET /v3/session/{sessionId}/signatures/{nodeId}/documents/{documentId}/file/","href":"/ko/sessions-api/electronic-signature/download-signed-document"},{"title":"전자 서명 증거 API: 감사 추적 PDF","sidebarTitle":"서명 증거 다운로드","openapi":"ko/openapi-25.json GET /v3/session/{sessionId}/signatures/{nodeId}/evidence/","href":"/ko/sessions-api/electronic-signature/download-evidence"},{"title":"서명 이미지 API: 전자 서명 필드 PNG 다운로드","sidebarTitle":"서명 이미지 다운로드","openapi":"ko/openapi-25.json GET /v3/session/{sessionId}/signatures/{nodeId}/fields/{fieldId}/image/","href":"/ko/sessions-api/electronic-signature/download-field-image"},{"title":"서명 검증 API: 서명된 PDF 재검증","sidebarTitle":"서명 검증","openapi":"ko/openapi-25.json POST /v3/session/{sessionId}/signatures/{nodeId}/validate/","href":"/ko/sessions-api/electronic-signature/validate-signatures"}]},{"title":"세션 공유 API: 파트너 간 재사용 가능한 KYC","sidebarTitle":"개요","href":"/ko/sessions-api/share-session/overview"},{"title":"세션 공유 API: 공유 토큰 생성","sidebarTitle":"세션 공유","openapi":"ko/openapi-25.json POST /v3/session/{sessionId}/share/","href":"/ko/sessions-api/share-session/share"},{"title":"공유 세션 가져오기 API: 재사용 가능한 KYC 및 KYB","sidebarTitle":"공유 세션 가져오기","openapi":"ko/openapi-25.json POST /v3/session/import-shared/","href":"/ko/sessions-api/share-session/import"}]},{"group":"목록","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/lists.svg","pages":[{"title":"차단 목록 및 허용 목록 API (Lists API)","sidebarTitle":"개요","href":"/ko/management-api/lists/overview"},{"title":"모든 리스트 조회 API: 차단 목록 및 허용 목록","sidebarTitle":"리스트 목록 조회","openapi":"ko/openapi-25.json GET /v3/lists/","href":"/ko/management-api/lists/list"},{"title":"리스트 생성 API: 허용 목록 및 사용자 지정 목록","sidebarTitle":"리스트 생성","openapi":"ko/openapi-25.json POST /v3/lists/","href":"/ko/management-api/lists/create"},{"title":"리스트 조회 API: 컴플라이언스 리스트 정보 가져오기","sidebarTitle":"리스트 조회","openapi":"ko/openapi-25.json GET /v3/lists/{list_uuid}/","href":"/ko/management-api/lists/get"},{"title":"목록 수정 API: 컴플라이언스 목록 편집","sidebarTitle":"목록 수정","openapi":"ko/openapi-25.json PATCH /v3/lists/{list_uuid}/","href":"/ko/management-api/lists/update"},{"title":"목록 삭제 API: 컴플라이언스 목록 제거","sidebarTitle":"목록 삭제","openapi":"ko/openapi-25.json DELETE /v3/lists/{list_uuid}/","href":"/ko/management-api/lists/delete"},{"title":"목록 항목 API: 차단 목록 및 허용 목록 항목 조회","sidebarTitle":"목록 항목","openapi":"ko/openapi-25.json GET /v3/lists/{list_uuid}/entries/","href":"/ko/management-api/lists/list-entries"},{"title":"리스트 항목 생성 API: 차단 목록 및 허용 목록","sidebarTitle":"리스트 항목 생성","openapi":"ko/openapi-25.json POST /v3/lists/{list_uuid}/entries/","href":"/ko/management-api/lists/create-entry"},{"title":"리스트 항목 삭제 API: 차단 해제","sidebarTitle":"리스트 항목 삭제","openapi":"ko/openapi-25.json DELETE /v3/lists/{list_uuid}/entries/{entry_uuid}/","href":"/ko/management-api/lists/delete-entry"},{"title":"얼굴 업로드 API: 생체 정보 목록","sidebarTitle":"얼굴 업로드","openapi":"ko/openapi-25.json POST /v3/lists/{list_uuid}/entries/face-upload/","href":"/ko/management-api/lists/upload-face"}]},{"group":"차단 목록","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/lists.svg","pages":[{"title":"차단 목록 항목 조회 API","sidebarTitle":"차단 목록 항목 조회","openapi":"ko/openapi-25.json GET /v3/blocklist/","href":"/ko/management-api/blocklist/list"},{"title":"차단 목록 추가 API: 세션 항목 차단","sidebarTitle":"차단 목록에 추가","openapi":"ko/openapi-25.json POST /v3/blocklist/add/","href":"/ko/management-api/blocklist/add"},{"title":"차단 목록에서 제거 API: 세션 항목 차단 해제","sidebarTitle":"차단 목록에서 제거","openapi":"ko/openapi-25.json POST /v3/blocklist/remove/","href":"/ko/management-api/blocklist/remove"}]},{"group":"워크플로","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/workflows.svg","pages":[{"title":"워크플로 목록 조회 API: 인증 플로우 관리","sidebarTitle":"워크플로 목록 조회","openapi":"ko/openapi-25.json GET /v3/workflows/","href":"/ko/management-api/workflows/list"},{"title":"워크플로 생성 API: KYC 플로 구축","sidebarTitle":"워크플로 생성","openapi":"ko/openapi-25.json POST /v3/workflows/","href":"/ko/management-api/workflows/create"},{"title":"워크플로 기능 설정 API 레퍼런스","sidebarTitle":"워크플로 기능 설정","href":"/ko/management-api/workflows/feature-configs"},{"title":"워크플로 조회 API: KYC 워크플로 가져오기","sidebarTitle":"워크플로 조회","openapi":"ko/openapi-25.json GET /v3/workflows/{settings_uuid}/","href":"/ko/management-api/workflows/get"},{"title":"워크플로 업데이트 API: KYC 워크플로 수정","sidebarTitle":"워크플로 업데이트","openapi":"ko/openapi-25.json PATCH /v3/workflows/{settings_uuid}/","href":"/ko/management-api/workflows/update"},{"title":"워크플로 삭제 API: KYC 워크플로 제거","sidebarTitle":"워크플로 삭제","openapi":"ko/openapi-25.json DELETE /v3/workflows/{settings_uuid}/","href":"/ko/management-api/workflows/delete"}]},{"group":"설문지","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/task-square.svg","pages":[{"title":"설문지 목록 조회 API: KYC 양식","sidebarTitle":"설문지 목록 조회","openapi":"ko/openapi-25.json GET /v3/questionnaires/","href":"/ko/management-api/questionnaires/list"},{"title":"설문지 생성 API: 맞춤형 KYC 양식","sidebarTitle":"설문지 생성","openapi":"ko/openapi-25.json POST /v3/questionnaires/","href":"/ko/management-api/questionnaires/create"},{"title":"KYC 설문지 조회 API: 설문지 상세 정보 가져오기","sidebarTitle":"설문지 조회","openapi":"ko/openapi-25.json GET /v3/questionnaires/{questionnaire_uuid}/","href":"/ko/management-api/questionnaires/get"},{"title":"설문지 업데이트 API: KYC 양식 수정","sidebarTitle":"설문지 업데이트","openapi":"ko/openapi-25.json PATCH /v3/questionnaires/{questionnaire_uuid}/","href":"/ko/management-api/questionnaires/update"},{"title":"Questionnaire 삭제 API: KYC 설문지 제거","sidebarTitle":"Questionnaire 삭제","openapi":"ko/openapi-25.json DELETE /v3/questionnaires/{questionnaire_uuid}/","href":"/ko/management-api/questionnaires/delete"}]},{"group":"사용자","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/users.svg","pages":[{"title":"사용자 목록 API: 벤더 사용자 엔티티 조회","sidebarTitle":"사용자 목록","openapi":"ko/openapi-25.json GET /v3/users/","href":"/ko/management-api/users/list"},{"title":"사용자 생성 API: 벤더 사용자 엔티티","sidebarTitle":"사용자 생성","openapi":"ko/openapi-25.json POST /v3/users/create/","href":"/ko/management-api/users/create"},{"title":"사용자 얼굴 업로드 API: 벤더 사용자 프로필","sidebarTitle":"사용자 얼굴 업로드","openapi":"ko/openapi-25.json POST /v3/organization/{organization_id}/application/{application_id}/vendor-users/by-id/{didit_internal_id}/faces/upload/","href":"/ko/management-api/users/upload-face"},{"title":"사용자 조회 API: 벤더 사용자 엔티티","sidebarTitle":"사용자 조회","openapi":"ko/openapi-25.json GET /v3/users/{vendor_data}/","href":"/ko/management-api/users/get"},{"title":"사용자 이력 PDF API: 사용자의 모든 세션","sidebarTitle":"사용자 이력 PDF","openapi":"ko/openapi-25.json GET /v3/users/{vendor_data}/generate-pdf/","href":"/ko/management-api/users/generate-pdf"},{"title":"사용자 업데이트 API: 벤더 사용자 엔티티","sidebarTitle":"사용자 업데이트","openapi":"ko/openapi-25.json PATCH /v3/users/{vendor_data}/","href":"/ko/management-api/users/update"},{"title":"사용자 상태 업데이트 API: 차단 또는 플래그 지정","sidebarTitle":"사용자 상태 업데이트","openapi":"ko/openapi-25.json PATCH /v3/users/{vendor_data}/update-status/","href":"/ko/management-api/users/update-status"},{"title":"사용자 일괄 삭제 API: GDPR 삭제권","sidebarTitle":"사용자 일괄 삭제","openapi":"ko/openapi-25.json POST /v3/users/delete/","href":"/ko/management-api/users/delete"}]},{"group":"생체 인식 템플릿","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/liveness.svg","pages":[{"title":"생체 인식 템플릿 API","sidebarTitle":"개요","href":"/ko/management-api/biometric-templates/overview"},{"title":"생체 인식 템플릿 목록 조회 API","sidebarTitle":"템플릿 목록","openapi":"ko/openapi-25.json GET /v3/biometric-templates/","href":"/ko/management-api/biometric-templates/list"},{"title":"생체 인식 템플릿 개수 조회 API","sidebarTitle":"템플릿 개수 조회","openapi":"ko/openapi-25.json GET /v3/biometric-templates/count/","href":"/ko/management-api/biometric-templates/count"},{"title":"생체 인식 템플릿 조회 API","sidebarTitle":"템플릿 조회","openapi":"ko/openapi-25.json GET /v3/biometric-templates/{template_uuid}/","href":"/ko/management-api/biometric-templates/get"},{"title":"생체 인식 템플릿 삭제 API","sidebarTitle":"템플릿 삭제","openapi":"ko/openapi-25.json DELETE /v3/biometric-templates/{template_uuid}/","href":"/ko/management-api/biometric-templates/purge"},{"title":"생체 인식 템플릿 일괄 삭제 API","sidebarTitle":"일괄 삭제","openapi":"ko/openapi-25.json POST /v3/biometric-templates/delete/","href":"/ko/management-api/biometric-templates/batch-purge"}]},{"group":"기업","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/businesses.svg","pages":[{"title":"기업 목록 조회 API: 벤더 KYB 엔티티","sidebarTitle":"기업 목록 조회","openapi":"ko/openapi-25.json GET /v3/businesses/","href":"/ko/management-api/businesses/list"},{"title":"기업 생성 API: 벤더 KYB 엔티티","sidebarTitle":"기업 생성","openapi":"ko/openapi-25.json POST /v3/businesses/create/","href":"/ko/management-api/businesses/create"},{"title":"기업 조회 API: 벤더 KYB 엔티티","sidebarTitle":"기업 조회","openapi":"ko/openapi-25.json GET /v3/businesses/{vendor_data}/","href":"/ko/management-api/businesses/get"},{"title":"기업 확인(KYB) 세션 PDF API","sidebarTitle":"기업 세션 PDF 생성","openapi":"ko/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/businesses/{business_session_id}/pdf/","href":"/ko/management-api/businesses/generate-session-pdf"},{"title":"기업 정보 업데이트 API: 공급업체 KYB 엔티티","sidebarTitle":"기업 정보 업데이트","openapi":"ko/openapi-25.json PATCH /v3/businesses/{vendor_data}/","href":"/ko/management-api/businesses/update"},{"title":"기업 상태 업데이트 API: 차단 또는 표시","sidebarTitle":"기업 상태 업데이트","openapi":"ko/openapi-25.json PATCH /v3/businesses/{vendor_data}/update-status/","href":"/ko/management-api/businesses/update-status"},{"title":"기업 일괄 삭제 API: KYB 데이터 삭제","sidebarTitle":"기업 일괄 삭제","openapi":"ko/openapi-25.json POST /v3/businesses/delete/","href":"/ko/management-api/businesses/delete"}]},{"group":"지속적인 AML 모니터링","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/aml-screening.svg","pages":[{"title":"사용자 AML 모니터링 일괄 설정 API","sidebarTitle":"사용자 일괄 설정","openapi":"ko/openapi-25.json POST /v3/users/aml-monitoring/","href":"/ko/management-api/aml-monitoring/toggle-users"},{"title":"기업 AML 모니터링 전환 API","sidebarTitle":"기업 전환","openapi":"ko/openapi-25.json POST /v3/businesses/aml-monitoring/","href":"/ko/management-api/aml-monitoring/toggle-businesses"},{"title":"AML 모니터링 작업 조회 API","sidebarTitle":"AML 모니터링 작업 조회","openapi":"ko/openapi-25.json GET /v3/aml-monitoring/jobs/{job_id}/","href":"/ko/management-api/aml-monitoring/get-job"}]},{"group":"케이스","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/clipboard-check.svg","pages":[{"title":"케이스 목록 조회 API","sidebarTitle":"케이스 목록","openapi":"ko/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/cases/","href":"/ko/management-api/cases/list"},{"title":"케이스 생성 API","sidebarTitle":"케이스 생성","openapi":"ko/openapi-25.json POST /v3/organization/{organization_id}/application/{application_id}/cases/","href":"/ko/management-api/cases/create"},{"title":"케이스 조회 API","sidebarTitle":"케이스 조회","openapi":"ko/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/","href":"/ko/management-api/cases/get"},{"title":"케이스 업데이트 API","sidebarTitle":"케이스 업데이트","openapi":"ko/openapi-25.json PATCH /v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/","href":"/ko/management-api/cases/update"},{"title":"케이스 삭제 API","sidebarTitle":"케이스 삭제","openapi":"ko/openapi-25.json DELETE /v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/","href":"/ko/management-api/cases/delete"},{"title":"케이스 해결 API","sidebarTitle":"케이스 해결","openapi":"ko/openapi-25.json POST /v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/resolve/","href":"/ko/management-api/cases/resolve"},{"title":"케이스 정보 요청 API","sidebarTitle":"정보 요청 (사용자 대기)","openapi":"ko/openapi-25.json POST /v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/request-info/","href":"/ko/management-api/cases/request-info"},{"title":"케이스 이전 API","sidebarTitle":"케이스 이전","openapi":"ko/openapi-25.json POST /v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/transfer/","href":"/ko/management-api/cases/transfer"},{"title":"케이스 PDF 출력 API","sidebarTitle":"케이스 출력","openapi":"ko/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/print/","href":"/ko/management-api/cases/print"},{"title":"케이스 분석 API","sidebarTitle":"케이스 분석","openapi":"ko/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/cases/statistics/","href":"/ko/management-api/cases/statistics"},{"title":"케이스 상태 일괄 업데이트 API","sidebarTitle":"케이스 상태 일괄 업데이트","openapi":"ko/openapi-25.json POST /v3/organization/{organization_id}/application/{application_id}/cases/bulk/status/","href":"/ko/management-api/cases/bulk-status"},{"title":"케이스 메모 조회 API","sidebarTitle":"케이스 메모 조회","openapi":"ko/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/notes/","href":"/ko/management-api/cases/list-notes"},{"title":"케이스 노트 생성 API","sidebarTitle":"케이스 노트 생성","openapi":"ko/openapi-25.json POST /v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/notes/","href":"/ko/management-api/cases/create-note"}]},{"group":"케이스 블루프린트","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/sliders.svg","pages":[{"title":"케이스 블루프린트 목록 조회 API","sidebarTitle":"케이스 블루프린트 목록","openapi":"ko/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/cases/blueprints/","href":"/ko/management-api/case-blueprints/list"},{"title":"케이스 블루프린트 생성 API","sidebarTitle":"케이스 블루프린트 생성","openapi":"ko/openapi-25.json POST /v3/organization/{organization_id}/application/{application_id}/cases/blueprints/","href":"/ko/management-api/case-blueprints/create"},{"title":"케이스 블루프린트 프리셋 설치 API","sidebarTitle":"프리셋 설치","openapi":"ko/openapi-25.json POST /v3/organization/{organization_id}/application/{application_id}/cases/blueprints/presets/install/","href":"/ko/management-api/case-blueprints/install-presets"}]},{"group":"네트워크","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/link.svg","pages":[{"title":"사기 네트워크 목록 조회 API","sidebarTitle":"네트워크 목록 조회","openapi":"ko/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/networks/","href":"/ko/management-api/networks/list"},{"title":"사기 네트워크 조회 API","sidebarTitle":"네트워크 조회","openapi":"ko/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/","href":"/ko/management-api/networks/get"},{"title":"사기 네트워크에 태그 추가 API","sidebarTitle":"네트워크 태그 추가","openapi":"ko/openapi-25.json POST /v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/tags/add/","href":"/ko/management-api/networks/add-tag"},{"title":"사기 네트워크 태그 제거 API","sidebarTitle":"네트워크 태그 제거","openapi":"ko/openapi-25.json POST /v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/tags/remove/","href":"/ko/management-api/networks/remove-tag"},{"title":"사기 네트워크 그래프 API","sidebarTitle":"네트워크 그래프 조회","openapi":"ko/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/graph/","href":"/ko/management-api/networks/graph"},{"title":"사기 네트워크 멤버 목록 조회 API","sidebarTitle":"네트워크 멤버 목록","openapi":"ko/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/members/","href":"/ko/management-api/networks/members"},{"title":"사기 네트워크 신호 목록 API","sidebarTitle":"네트워크 신호 목록","openapi":"ko/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/signals/","href":"/ko/management-api/networks/signals"},{"title":"사기 네트워크 타임라인 API","sidebarTitle":"네트워크 타임라인 조회","openapi":"ko/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/timeline/","href":"/ko/management-api/networks/timeline"},{"title":"사기 네트워크 맵 API","sidebarTitle":"네트워크 맵 조회","openapi":"ko/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/map/","href":"/ko/management-api/networks/map"},{"title":"네트워크 멤버십 조회 API","sidebarTitle":"멤버십 조회","href":"/ko/management-api/networks/membership-lookup"}]},{"group":"보고서 템플릿","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/task-square.svg","pages":[{"title":"보고서 템플릿 목록 조회 API","sidebarTitle":"보고서 템플릿 목록 조회","openapi":"ko/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/report-templates/","href":"/ko/management-api/report-templates/list"},{"title":"보고서 템플릿 생성 API","sidebarTitle":"보고서 템플릿 생성","openapi":"ko/openapi-25.json POST /v3/organization/{organization_id}/application/{application_id}/report-templates/","href":"/ko/management-api/report-templates/create"}]},{"group":"규제 보고서","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/search-file.svg","pages":[{"title":"케이스에서 FIU 보고서 생성 API","sidebarTitle":"케이스에서 보고서 생성","openapi":"ko/openapi-25.json POST /v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/regulatory-reports/","href":"/ko/management-api/regulatory-reports/create-for-case"},{"title":"FIU 보고서 목록 조회 API","sidebarTitle":"보고서 목록","openapi":"ko/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/regulatory-reports/","href":"/ko/management-api/regulatory-reports/list"},{"title":"FIU 보고서 검증 API","sidebarTitle":"보고서 검증","openapi":"ko/openapi-25.json POST /v3/organization/{organization_id}/application/{application_id}/regulatory-reports/{report_uuid}/validate/","href":"/ko/management-api/regulatory-reports/validate"},{"title":"FIU 보고서 확정 API","sidebarTitle":"보고서 확정","openapi":"ko/openapi-25.json POST /v3/organization/{organization_id}/application/{application_id}/regulatory-reports/{report_uuid}/finalize/","href":"/ko/management-api/regulatory-reports/finalize"},{"title":"FIU 보고서 삭제 API","sidebarTitle":"보고서 삭제","openapi":"ko/openapi-25.json DELETE /v3/organization/{organization_id}/application/{application_id}/regulatory-reports/{report_uuid}/","href":"/ko/management-api/regulatory-reports/delete"},{"title":"FIU 보고서 다운로드 URL 조회 API","sidebarTitle":"보고서 다운로드 URL 조회","openapi":"ko/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/regulatory-reports/{report_uuid}/download-url/","href":"/ko/management-api/regulatory-reports/download-url"}]},{"group":"거래","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/transactions.svg","pages":[{"title":"거래 목록 조회 API: KYT 모니터링","sidebarTitle":"거래 목록 조회","openapi":"ko/openapi-25.json GET /v3/transactions/","href":"/ko/management-api/transactions/list"},{"title":"거래 생성 API: KYT 제출","sidebarTitle":"거래 생성","openapi":"ko/openapi-25.json POST /v3/transactions/","href":"/ko/management-api/transactions/create"},{"title":"거래 일괄 삭제 API","sidebarTitle":"거래 일괄 삭제","openapi":"ko/openapi-25.json DELETE /v3/organization/{organization_id}/application/{application_id}/transactions/delete/","href":"/ko/management-api/transactions/delete"},{"title":"거래 조회 API: KYT 상세 정보","sidebarTitle":"거래 조회","openapi":"ko/openapi-25.json GET /v3/transactions/{transaction_id}/","href":"/ko/management-api/transactions/get"},{"title":"거래 메모 목록 조회 API","sidebarTitle":"거래 메모 목록 조회","openapi":"ko/openapi-25.json GET /v3/transactions/{transaction_id}/notes/","href":"/ko/management-api/transactions/list-notes"},{"title":"거래 메모 생성 API","sidebarTitle":"거래 메모 생성","openapi":"ko/openapi-25.json POST /v3/transactions/{transaction_id}/notes/","href":"/ko/management-api/transactions/create-note"},{"title":"관련 거래 조회 API","sidebarTitle":"관련 거래 조회","openapi":"ko/openapi-25.json GET /v3/transactions/{transaction_id}/related/","href":"/ko/management-api/transactions/list-related"},{"title":"거래 PDF 보고서 API","sidebarTitle":"거래 PDF 보고서 생성","openapi":"ko/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/transactions/{transaction_uuid}/pdf/","href":"/ko/management-api/transactions/generate-pdf"},{"title":"지갑 스크리닝 API: 온디맨드 암호화폐 AML 점검","sidebarTitle":"지갑 스크리닝","openapi":"ko/openapi-25.json POST /v3/wallet-screening/","href":"/ko/management-api/transactions/screen-wallet"},{"title":"지갑 스크리닝 PDF 보고서 API","sidebarTitle":"지갑 스크리닝 PDF","openapi":"ko/openapi-25.json POST /v3/wallet-screening/pdf/","href":"/ko/management-api/transactions/screen-wallet-pdf"},{"title":"SDK 거래 토큰 발급 API: 클라이언트 측 KYT","sidebarTitle":"SDK 거래 토큰 발급","openapi":"ko/openapi-25.json POST /v3/transactions/sdk-token/","href":"/ko/management-api/transactions/sdk-token"},{"title":"SDK에서 거래 제출하기: 클라이언트 측 KYT","sidebarTitle":"거래 제출 (SDK 토큰)","openapi":"ko/openapi-25.json POST /v1/transactions/","href":"/ko/management-api/transactions/submit-sdk"},{"title":"SDK로 거래 조회: 클라이언트 측 KYT","sidebarTitle":"거래 조회 (SDK 토큰)","openapi":"ko/openapi-25.json GET /v1/transactions/{transaction_id}/","href":"/ko/management-api/transactions/get-sdk"},{"title":"거래 모니터링 규칙 목록 조회 API","sidebarTitle":"규칙 목록 조회","openapi":"ko/openapi-25.json GET /v3/transactions/rules/","href":"/ko/management-api/transactions/rules-list"},{"title":"거래 모니터링 규칙 생성 API - KYT 규칙","sidebarTitle":"규칙 생성","openapi":"ko/openapi-25.json POST /v3/transactions/rules/","href":"/ko/management-api/transactions/rules-create"},{"title":"거래 모니터링 규칙 조회 API","sidebarTitle":"규칙 조회","openapi":"ko/openapi-25.json GET /v3/transactions/rules/{rule_uuid}/","href":"/ko/management-api/transactions/rules-get"},{"title":"거래 모니터링 규칙 업데이트 API","sidebarTitle":"규칙 업데이트","openapi":"ko/openapi-25.json PATCH /v3/transactions/rules/{rule_uuid}/","href":"/ko/management-api/transactions/rules-update"},{"title":"거래 모니터링 규칙 삭제 API","sidebarTitle":"규칙 삭제","openapi":"ko/openapi-25.json DELETE /v3/transactions/rules/{rule_uuid}/","href":"/ko/management-api/transactions/rules-delete"},{"title":"거래 모니터링 규칙 백테스트 API","sidebarTitle":"규칙 백테스트","openapi":"ko/openapi-25.json POST /v3/transactions/rules/backtest/","href":"/ko/management-api/transactions/rules-backtest"},{"title":"거래 모니터링 규칙 라이브러리 API - 150+ 프리셋","sidebarTitle":"규칙 라이브러리 조회","openapi":"ko/openapi-25.json GET /v3/transactions/rules/library/","href":"/ko/management-api/transactions/rules-library"},{"title":"프리셋 거래 모니터링 규칙 설치 API","sidebarTitle":"라이브러리 규칙 설치","openapi":"ko/openapi-25.json POST /v3/transactions/rules/install/","href":"/ko/management-api/transactions/rules-install"},{"title":"사전 설정 거래 모니터링 규칙 제거 API","sidebarTitle":"라이브러리 규칙 제거","openapi":"ko/openapi-25.json DELETE /v3/transactions/rules/install/","href":"/ko/management-api/transactions/rules-uninstall"}]},{"group":"모니터링 이벤트","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/transactions.svg","pages":[{"title":"모니터링 이벤트 목록 조회 API","sidebarTitle":"모니터링 이벤트 목록 조회","openapi":"ko/openapi-25.json GET /v3/events/","href":"/ko/management-api/monitoring-events/list"},{"title":"모니터링 이벤트 생성 API","sidebarTitle":"모니터링 이벤트 생성","openapi":"ko/openapi-25.json POST /v3/events/","href":"/ko/management-api/monitoring-events/create"},{"title":"모니터링 이벤트 일괄 생성 API","sidebarTitle":"모니터링 이벤트 일괄 생성","openapi":"ko/openapi-25.json POST /v3/events/batch/","href":"/ko/management-api/monitoring-events/create-batch"},{"title":"모니터링 SDK 토큰 발급 API","sidebarTitle":"모니터링 SDK 토큰 발급","openapi":"ko/openapi-25.json POST /v3/events/sdk-token/","href":"/ko/management-api/monitoring-events/sdk-token"},{"title":"모니터링 이벤트 조회 API","sidebarTitle":"모니터링 이벤트 조회","openapi":"ko/openapi-25.json GET /v3/events/{event_uuid}/","href":"/ko/management-api/monitoring-events/get"},{"title":"대상자 이벤트 타임라인 API","sidebarTitle":"이벤트 타임라인 조회","openapi":"ko/openapi-25.json GET /v3/events/subjects/{vendor_data}/","href":"/ko/management-api/monitoring-events/subject-timeline"},{"title":"이벤트 보강 지표 API","sidebarTitle":"이벤트 보강 지표 조회","openapi":"ko/openapi-25.json GET /v3/events/enrichment-metrics/","href":"/ko/management-api/monitoring-events/enrichment-metrics"},{"title":"모니터링 이벤트 삭제 API","sidebarTitle":"모니터링 이벤트 삭제","openapi":"ko/openapi-25.json DELETE /v3/events/{event_uuid}/delete/","href":"/ko/management-api/monitoring-events/delete"}]},{"group":"Travel Rule","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/transactions.svg","pages":[{"title":"Travel Rule 설정 조회 API: VASP 프로필","sidebarTitle":"Travel Rule 설정 조회","openapi":"ko/openapi-25.json GET /v3/travel-rule/settings/","href":"/ko/management-api/travel-rule/get-settings"},{"title":"Travel Rule 설정 업데이트 API: 활성화 및 구성","sidebarTitle":"Travel Rule 설정 업데이트","openapi":"ko/openapi-25.json PUT /v3/travel-rule/settings/","href":"/ko/management-api/travel-rule/update-settings"},{"title":"Travel Rule 네트워크 조회 API","sidebarTitle":"Travel Rule 네트워크 조회","openapi":"ko/openapi-25.json GET /v3/travel-rule/networks/","href":"/ko/management-api/travel-rule/get-networks"},{"title":"Travel Rule 네트워크 설문지 조회 API","sidebarTitle":"네트워크 설문지 조회","openapi":"ko/openapi-25.json GET /v3/travel-rule/networks/questionnaire/","href":"/ko/management-api/travel-rule/get-network-questionnaire"},{"title":"Travel Rule 네트워크 설문지 답변 저장 API","sidebarTitle":"네트워크 설문지 답변 저장","openapi":"ko/openapi-25.json PUT /v3/travel-rule/networks/questionnaire/","href":"/ko/management-api/travel-rule/update-network-questionnaire"},{"title":"Travel Rule 네트워크 설문지 제출 API","sidebarTitle":"네트워크 설문지 제출","openapi":"ko/openapi-25.json POST /v3/travel-rule/networks/questionnaire/submit/","href":"/ko/management-api/travel-rule/submit-network-questionnaire"},{"title":"Travel Rule 네트워크 접근 요청 API","sidebarTitle":"Travel Rule 네트워크 요청","openapi":"ko/openapi-25.json POST /v3/travel-rule/networks/{network}/request/","href":"/ko/management-api/travel-rule/request-network"},{"title":"Travel Rule 컴플라이언스 이메일 확인 API","sidebarTitle":"컴플라이언스 이메일 확인 메일 발송","openapi":"ko/openapi-25.json POST /v3/travel-rule/settings/compliance-email/confirmation/","href":"/ko/management-api/travel-rule/send-compliance-email-confirmation"},{"title":"Travel Rule 전송 목록 조회 API","sidebarTitle":"Travel Rule 전송 목록","openapi":"ko/openapi-25.json GET /v3/travel-rule/transfers/","href":"/ko/management-api/travel-rule/list-transfers"},{"title":"매칭되지 않은 Travel Rule 입금 목록 API","sidebarTitle":"미매칭 입금 목록","openapi":"ko/openapi-25.json GET /v3/travel-rule/unmatched/","href":"/ko/management-api/travel-rule/list-unmatched-deposits"},{"title":"Travel Rule 입금 매칭 API: 메시지 연결","sidebarTitle":"미매칭 입금 연결","openapi":"ko/openapi-25.json POST /v3/travel-rule/unmatched/{transaction_uuid}/match/","href":"/ko/management-api/travel-rule/match-unmatched-deposit"},{"title":"Travel Rule 전송 작업 API: 완료, 재전송, 업데이트","sidebarTitle":"전송 완료, 취소, 재전송 또는 업데이트","openapi":"ko/openapi-25.json PATCH /v3/transactions/{transaction_id}/travel-rule/","href":"/ko/management-api/travel-rule/update-transfer"},{"title":"지갑 소유권 확인 API: Travel Rule 수취인","sidebarTitle":"지갑 소유권 확인 또는 거부","openapi":"ko/openapi-25.json POST /v3/transactions/{transaction_id}/travel-rule/ownership/","href":"/ko/management-api/travel-rule/confirm-ownership"},{"title":"Travel Rule 메시지 목록 조회 API","sidebarTitle":"Travel Rule 메시지 조회","openapi":"ko/openapi-25.json GET /v3/transactions/{transaction_id}/travel-rule/messages/","href":"/ko/management-api/travel-rule/list-messages"},{"title":"Travel Rule 메시지 전송 API","sidebarTitle":"Travel Rule 메시지 전송","openapi":"ko/openapi-25.json POST /v3/transactions/{transaction_id}/travel-rule/messages/","href":"/ko/management-api/travel-rule/create-message"},{"title":"Travel Rule 인바운드 거래 등록 API (Sunrise)","sidebarTitle":"인바운드(Sunrise) 거래 등록","openapi":"ko/openapi-25.json POST /v3/travel-rule/inbound/","href":"/ko/management-api/travel-rule/register-inbound"},{"title":"Travel Rule 테스트 VASP 인바운드 전송 트리거 API","sidebarTitle":"테스트 인바운드 전송 트리거","openapi":"ko/openapi-25.json POST /v3/travel-rule/test-vasp/inbound/","href":"/ko/management-api/travel-rule/trigger-test-vasp-inbound"},{"title":"VASP 디렉터리 검색 API: Travel Rule 경로","sidebarTitle":"VASP 디렉터리 검색","openapi":"ko/openapi-25.json GET /v3/travel-rule/vasps/","href":"/ko/management-api/travel-rule/search-vasps"},{"title":"VASP 디렉터리 항목 조회 API: Travel Rule 경로","sidebarTitle":"VASP 디렉터리 항목 조회","openapi":"ko/openapi-25.json GET /v3/travel-rule/vasps/{vasp_id}/","href":"/ko/management-api/travel-rule/get-vasp"},{"title":"Travel Rule 거래 상대방 VASP 결정 조회 API","sidebarTitle":"VASP 결정 조회","openapi":"ko/openapi-25.json GET /v3/travel-rule/vasps/{vasp_id}/decision/","href":"/ko/management-api/travel-rule/get-vasp-decision"},{"title":"거래 상대방 VASP 결정 설정 API: Travel Rule","sidebarTitle":"VASP 결정 설정","openapi":"ko/openapi-25.json PUT /v3/travel-rule/vasps/{vasp_id}/decision/","href":"/ko/management-api/travel-rule/set-vasp-decision"},{"title":"Travel Rule 거래 상대방 VASP 결정 해제 API","sidebarTitle":"VASP 결정 해제하기","openapi":"ko/openapi-25.json DELETE /v3/travel-rule/vasps/{vasp_id}/decision/","href":"/ko/management-api/travel-rule/clear-vasp-decision"},{"title":"거래 상대방 VASP 스크리닝 조회 API: Travel Rule","sidebarTitle":"VASP 실체 스크리닝 조회","openapi":"ko/openapi-25.json GET /v3/travel-rule/vasps/{vasp_id}/screening/","href":"/ko/management-api/travel-rule/get-vasp-screening"},{"title":"거래 상대방 VASP 스크리닝 API: 제재 확인","sidebarTitle":"거래 상대방 VASP 스크리닝","openapi":"ko/openapi-25.json POST /v3/travel-rule/vasps/{vasp_id}/screening/","href":"/ko/management-api/travel-rule/screen-vasp"},{"title":"VASP 실사 설문지 목록 조회 API","sidebarTitle":"VASP 실사 설문지 목록 조회","openapi":"ko/openapi-25.json GET /v3/travel-rule/vasps/{vasp_id}/questionnaires/","href":"/ko/management-api/travel-rule/list-vasp-questionnaires"},{"title":"VASP 실사 설문지 전송 API","sidebarTitle":"VASP에 실사 설문지 전송","openapi":"ko/openapi-25.json POST /v3/travel-rule/vasps/{vasp_id}/questionnaires/","href":"/ko/management-api/travel-rule/send-vasp-questionnaire"},{"title":"거래 상대방 연락처 조회 API - Travel Rule 이메일 채널","sidebarTitle":"거래 상대방 연락처 조회","openapi":"ko/openapi-25.json GET /v3/travel-rule/counterparty-contacts/","href":"/ko/management-api/travel-rule/list-counterparty-contacts"},{"title":"카운터파티 연락처 추가 API - Travel Rule 이메일 경로","sidebarTitle":"카운터파티 연락처 추가","openapi":"ko/openapi-25.json POST /v3/travel-rule/counterparty-contacts/","href":"/ko/management-api/travel-rule/create-counterparty-contact"},{"title":"거래 상대방 연락처 삭제 API - Travel Rule","sidebarTitle":"거래 상대방 연락처 삭제","openapi":"ko/openapi-25.json DELETE /v3/travel-rule/counterparty-contacts/{contact_uuid}/","href":"/ko/management-api/travel-rule/delete-counterparty-contact"},{"title":"지갑 주소 목록 조회 API: Travel Rule 주소록","sidebarTitle":"지갑 주소 목록 조회","openapi":"ko/openapi-25.json GET /v3/travel-rule/wallet-addresses/","href":"/ko/management-api/travel-rule/list-wallet-addresses"},{"title":"지갑 주소 등록 API: Travel Rule 주소록","sidebarTitle":"지갑 주소 등록","openapi":"ko/openapi-25.json POST /v3/travel-rule/wallet-addresses/","href":"/ko/management-api/travel-rule/create-wallet-address"},{"title":"주소 가져오기 API: Travel Rule 주소록","sidebarTitle":"주소 가져오기","openapi":"ko/openapi-25.json POST /v3/travel-rule/wallet-addresses/import/","href":"/ko/management-api/travel-rule/import-wallet-addresses"},{"title":"지갑 주소 업데이트 API: Travel Rule 주소록","sidebarTitle":"지갑 주소 업데이트","openapi":"ko/openapi-25.json PATCH /v3/travel-rule/wallet-addresses/{entry_uuid}/","href":"/ko/management-api/travel-rule/update-wallet-address"},{"title":"지갑 주소 삭제 API: Travel Rule 주소록","sidebarTitle":"지갑 주소 삭제","openapi":"ko/openapi-25.json DELETE /v3/travel-rule/wallet-addresses/{entry_uuid}/","href":"/ko/management-api/travel-rule/delete-wallet-address"},{"title":"스크린샷 지갑 증명 목록 조회 API - Travel Rule 검토","sidebarTitle":"검토 대기 지갑 증명 목록","openapi":"ko/openapi-25.json GET /v3/travel-rule/wallet-proofs/","href":"/ko/management-api/travel-rule/list-wallet-proofs"},{"title":"스크린샷 지갑 소유권 증명 승인 및 거부 API","sidebarTitle":"지갑 증명 결정","openapi":"ko/openapi-25.json POST /v3/travel-rule/wallet-proofs/{proof_uuid}/decision/","href":"/ko/management-api/travel-rule/decide-wallet-proof"},{"title":"지갑 소유권 위젯 API 세션 생성: 지갑 통제권 증명","sidebarTitle":"지갑 소유권 위젯 세션 생성","openapi":"ko/openapi-25.json POST /v3/travel-rule/widget-session/","href":"/ko/management-api/travel-rule/create-widget-session"},{"title":"지갑 소유권 위젯 컨텍스트 조회 API","sidebarTitle":"위젯 컨텍스트 조회","openapi":"ko/openapi-25.json GET /v3/travel-rule/widget/{token}/","href":"/ko/management-api/travel-rule/get-widget-context"},{"title":"지갑 소유권 증명 시작 API - Travel Rule 위젯","sidebarTitle":"위젯 증명 시작","openapi":"ko/openapi-25.json POST /v3/travel-rule/widget/{token}/proofs/","href":"/ko/management-api/travel-rule/create-widget-proof"},{"title":"지갑 소유권 증명 증거 제출 API - Travel Rule","sidebarTitle":"위젯 증명 증거 제출","openapi":"ko/openapi-25.json POST /v3/travel-rule/widget/{token}/proofs/{proof_id}/verify/","href":"/ko/management-api/travel-rule/verify-widget-proof"},{"title":"지갑 위젯 VASP 선택 API: Travel Rule 거래 상대방","sidebarTitle":"지갑 위젯에서 거래 상대방 VASP 선택","openapi":"ko/openapi-25.json POST /v3/travel-rule/widget/{token}/vasps/","href":"/ko/management-api/travel-rule/select-widget-vasp"},{"title":"위젯 VASP 선택기 API: Travel Rule 디렉터리 검색","sidebarTitle":"지갑 위젯에서 VASP 검색","openapi":"ko/openapi-25.json GET /v3/travel-rule/widget/{token}/vasps/","href":"/ko/management-api/travel-rule/search-widget-vasps"},{"title":"Travel Rule 이메일 픽업 정보 조회 API","sidebarTitle":"이메일 픽업 정보 조회","openapi":"ko/openapi-25.json GET /v3/travel-rule/pickup/{token}/","href":"/ko/management-api/travel-rule/get-pickup"},{"title":"Travel Rule 이메일 픽업 응답 API: 이메일 채널","sidebarTitle":"이메일 픽업 응답","openapi":"ko/openapi-25.json POST /v3/travel-rule/pickup/{token}/respond/","href":"/ko/management-api/travel-rule/respond-pickup"},{"title":"Travel Rule 픽업 메시지 조회 API - 이메일 레일","sidebarTitle":"픽업 메시지 조회","openapi":"ko/openapi-25.json GET /v3/travel-rule/pickup/{token}/messages/","href":"/ko/management-api/travel-rule/list-pickup-messages"},{"title":"Travel Rule 이메일 채널 픽업 포털 답장 API - Didit","sidebarTitle":"픽업 포털에서 답장","openapi":"ko/openapi-25.json POST /v3/travel-rule/pickup/{token}/messages/","href":"/ko/management-api/travel-rule/create-pickup-message"},{"title":"Travel Rule 무료 참여 초대 조회 API - Get Join Invitation","sidebarTitle":"참여 초대 조회","openapi":"ko/openapi-25.json GET /v3/travel-rule/join/{token}/","href":"/ko/management-api/travel-rule/get-join-invitation"},{"title":"Travel Rule 무료 계정 등록 API","sidebarTitle":"Travel Rule 무료 계정 등록","openapi":"ko/openapi-25.json POST /v3/travel-rule/join/{token}/","href":"/ko/management-api/travel-rule/register-join"},{"title":"Travel Rule 무료 계정 인증 API","sidebarTitle":"Travel Rule 무료 계정 인증","openapi":"ko/openapi-25.json POST /v3/travel-rule/join/{token}/verify/","href":"/ko/management-api/travel-rule/verify-join"},{"title":"Travel Rule 무료 가입 워크스페이스 조회 API","sidebarTitle":"무료 워크스페이스 조회","openapi":"ko/openapi-25.json GET /v3/travel-rule/workspace/","href":"/ko/management-api/travel-rule/get-workspace"},{"title":"디렉터리 항목 클레임 API - Travel Rule 무료 가입","sidebarTitle":"디렉터리 항목 클레임","openapi":"ko/openapi-25.json POST /v3/travel-rule/workspace/claim/","href":"/ko/management-api/travel-rule/claim-workspace"},{"title":"도메인 코드 발송 API - Travel Rule 무료 가입","sidebarTitle":"도메인 코드 발송","openapi":"ko/openapi-25.json POST /v3/travel-rule/workspace/domain/code/","href":"/ko/management-api/travel-rule/send-workspace-domain-code"},{"title":"도메인 코드 확인 API - Travel Rule 무료 가입","sidebarTitle":"도메인 코드 확인","openapi":"ko/openapi-25.json POST /v3/travel-rule/workspace/domain/confirm/","href":"/ko/management-api/travel-rule/confirm-workspace-domain"},{"title":"DNS 도메인 인증 API - Travel Rule 무료 가입","sidebarTitle":"DNS 도메인 인증","openapi":"ko/openapi-25.json POST /v3/travel-rule/workspace/domain/dns/","href":"/ko/management-api/travel-rule/verify-workspace-domain-dns"},{"title":"Travel Rule 아웃바운드 결제 활성화 API - Travel Rule 무료 가입","sidebarTitle":"아웃바운드 결제 활성화","openapi":"ko/openapi-25.json POST /v3/travel-rule/workspace/billing/","href":"/ko/management-api/travel-rule/enable-workspace-billing"}]},{"group":"세션 작업","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/play.svg","pages":[{"title":"세션 일괄 삭제 API: KYC 정리","sidebarTitle":"세션 일괄 삭제","openapi":"ko/openapi-25.json POST /v3/sessions/delete/","href":"/ko/management-api/sessions/batch-delete"},{"title":"세션 삭제 작업 조회 API","sidebarTitle":"세션 삭제 작업 조회","openapi":"ko/openapi-25.json GET /v3/sessions/delete/{job_id}/","href":"/ko/management-api/sessions/get-deletion-job"},{"title":"세션 검토 목록 API: KYC 감사 로그","sidebarTitle":"세션 검토 목록","openapi":"ko/openapi-25.json GET /v3/sessions/{session_id}/reviews/","href":"/ko/management-api/sessions/list-reviews"},{"title":"세션 검토 생성 API: KYC 수동 검토","sidebarTitle":"세션 검토 생성","openapi":"ko/openapi-25.json POST /v3/sessions/{session_id}/reviews/","href":"/ko/management-api/sessions/create-review"},{"title":"세션 이벤트 목록 조회 API","sidebarTitle":"세션 이벤트 조회","openapi":"ko/openapi-25.json GET /v3/session/{sessionId}/events/","href":"/ko/management-api/sessions/list-events"},{"title":"세션 webhook 전송 내역 조회 API","sidebarTitle":"세션 webhook 전송 내역 조회","openapi":"ko/openapi-25.json GET /v3/session/{sessionId}/webhooks/","href":"/ko/management-api/sessions/list-webhooks"},{"title":"세션 webhook 전송 상세 조회 API","sidebarTitle":"세션 webhook 전송 조회","openapi":"ko/openapi-25.json GET /v3/session/{sessionId}/webhook/{webhook_uuid}","href":"/ko/management-api/sessions/get-webhook"},{"title":"세션 webhook 전송 재요청 API","sidebarTitle":"세션 webhook 재전송","openapi":"ko/openapi-25.json POST /v3/session/{sessionId}/webhook/{webhook_uuid}/resend","href":"/ko/management-api/sessions/resend-webhook"},{"title":"AML 스크리닝 이력 조회 API","sidebarTitle":"AML 스크리닝 이력 조회","openapi":"ko/openapi-25.json GET /v3/session/{sessionId}/aml-screening-history/","href":"/ko/management-api/sessions/aml-screening-history"},{"title":"AML 스크리닝 기록 CSV 내보내기 API","sidebarTitle":"AML 스크리닝 기록 내보내기","openapi":"ko/openapi-25.json GET /v3/session/{sessionId}/aml-screening-history/export/","href":"/ko/management-api/sessions/export-aml-screening-history"}]},{"group":"사용자 지정","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/sliders.svg","pages":[{"title":"브랜딩 설정 조회 API","sidebarTitle":"브랜딩 조회","openapi":"ko/openapi-25.json GET /v3/customization/","href":"/ko/management-api/customization/get"},{"title":"브랜딩 업데이트 API (화이트 라벨 커스터마이징)","sidebarTitle":"브랜딩 업데이트","openapi":"ko/openapi-25.json PATCH /v3/customization/","href":"/ko/management-api/customization/update"}]},{"group":"webhook","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/link.svg","pages":[{"title":"웹훅 대상 목록 조회 API","sidebarTitle":"웹훅 대상 목록 조회","openapi":"ko/openapi-25.json GET /v3/webhook/destinations/","href":"/ko/management-api/webhook/list-destinations"},{"title":"webhook 대상 생성 API","sidebarTitle":"webhook 대상 생성","openapi":"ko/openapi-25.json POST /v3/webhook/destinations/","href":"/ko/management-api/webhook/create-destination"},{"title":"웹훅 대상 조회: Management API","sidebarTitle":"웹훅 대상 조회","openapi":"ko/openapi-25.json GET /v3/webhook/destinations/{destination_uuid}/","href":"/ko/management-api/webhook/get-destination"},{"title":"웹훅 대상 업데이트 API","sidebarTitle":"웹훅 대상 업데이트","openapi":"ko/openapi-25.json PATCH /v3/webhook/destinations/{destination_uuid}/","href":"/ko/management-api/webhook/update-destination"},{"title":"웹훅 대상 삭제 API","sidebarTitle":"웹훅 대상 삭제","openapi":"ko/openapi-25.json DELETE /v3/webhook/destinations/{destination_uuid}/","href":"/ko/management-api/webhook/delete-destination"},{"title":"웹훅 설정 조회 API","sidebarTitle":"웹훅 설정 조회","openapi":"ko/openapi-25.json GET /v3/webhook/","href":"/ko/management-api/webhook/get-config"},{"title":"webhook 설정 업데이트 API","sidebarTitle":"webhook 설정 업데이트","openapi":"ko/openapi-25.json PATCH /v3/webhook/","href":"/ko/management-api/webhook/update-config"},{"title":"Webhook 대상 분석 API - 전송 지표 및 실패율 조회","sidebarTitle":"Webhook 대상 분석 조회","openapi":"ko/openapi-25.json GET /v3/webhook/destinations/{destination_uuid}/analytics/","href":"/ko/management-api/webhook/destination-analytics"},{"title":"웹훅 전송 목록 조회 API","sidebarTitle":"웹훅 대상 전송 목록","openapi":"ko/openapi-25.json GET /v3/webhook/destinations/{destination_uuid}/deliveries/","href":"/ko/management-api/webhook/list-deliveries"},{"title":"웹훅 전송 상세 조회 API","sidebarTitle":"웹훅 대상 전송 조회","openapi":"ko/openapi-25.json GET /v3/webhook/destinations/{destination_uuid}/deliveries/{delivery_uuid}/","href":"/ko/management-api/webhook/get-delivery"},{"title":"웹훅 전송 재전송 API","sidebarTitle":"웹훅 대상 전송 재전송","openapi":"ko/openapi-25.json POST /v3/webhook/destinations/{destination_uuid}/deliveries/{delivery_uuid}/resend/","href":"/ko/management-api/webhook/resend-delivery"}]},{"group":"결제","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/billing.svg","pages":[{"title":"크레딧 잔액 조회 API: KYC 결제","sidebarTitle":"크레딧 잔액 조회","openapi":"ko/openapi-25.json GET /v3/billing/balance/","href":"/ko/management-api/billing/balance"},{"title":"크레딧 충전 API","sidebarTitle":"크레딧 충전","openapi":"ko/openapi-25.json POST /v3/billing/top-up/","href":"/ko/management-api/billing/top-up"}]},{"group":"분석","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/overview.svg","pages":[{"title":"애플리케이션 분석 API 가져오기","sidebarTitle":"애플리케이션 분석 조회","openapi":"ko/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/analytics/","href":"/ko/management-api/analytics/get"},{"title":"오늘 시간대별 사용자 인증 API","sidebarTitle":"오늘 시간대별 사용자 인증 조회","openapi":"ko/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/analytics/today/","href":"/ko/management-api/analytics/today-by-hour"}]},{"group":"관리 API 개요","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/info.svg","pages":[{"title":"관리 API v3: 워크플로 및 결제","sidebarTitle":"관리 API","href":"/ko/sessions-api/management-api"}]},{"group":"인증 API(프로그래밍 방식)","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/key.svg","pages":[{"title":"Auth API 프로그래밍 방식 등록","sidebarTitle":"계정 등록","openapi":"ko/openapi-auth.json POST /programmatic/register/","href":"/ko/auth-api/register"},{"title":"이메일 인증 API: Didit API 자격 증명 받기","sidebarTitle":"이메일 인증","openapi":"ko/openapi-auth.json POST /programmatic/verify-email/","href":"/ko/auth-api/verify-email"},{"title":"프로그래밍 방식 로그인 API: 헤드리스 인증 토큰","sidebarTitle":"로그인","openapi":"ko/openapi-auth.json POST /programmatic/login/","href":"/ko/auth-api/login"},{"title":"애플리케이션 자격 증명 API: client_id·api_key 조회","sidebarTitle":"자격 증명 조회","openapi":"ko/openapi-auth.json GET /organizations/me/{org_id}/applications/{app_id}/","href":"/ko/auth-api/get-credentials"},{"title":"애플리케이션 생성 API: 프로그래밍 방식 앱 생성","sidebarTitle":"애플리케이션 생성","openapi":"ko/openapi-auth.json POST /organizations/me/{org_id}/applications/","href":"/ko/auth-api/create-application"},{"title":"애플리케이션 업데이트 API: 고객 앱 관리","sidebarTitle":"애플리케이션 업데이트","openapi":"ko/openapi-auth.json PATCH /organizations/me/{org_id}/applications/{app_id}/","href":"/ko/auth-api/update-application"}]},{"group":"신원 및 문서","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/id-scan.svg","pages":[{"title":"신분증 인증 API: 문서 OCR 및 진위 확인","sidebarTitle":"신분증 인증 API","openapi":"ko/openapi-25.json POST /v3/id-verification/","href":"/ko/standalone-apis/id-verification"},{"title":"주소 증명 API: POA 인증 및 OCR","sidebarTitle":"주소 증명 API","openapi":"ko/openapi-25.json POST /v3/poa/","href":"/ko/standalone-apis/proof-of-address"},{"title":"주소 검증 API: 주소 확인 및 정규화","sidebarTitle":"주소 검증","openapi":"ko/openapi-25.json POST /v3/address-validation/","href":"/ko/standalone-apis/address-validation"}]},{"group":"디지털 신분증 지갑","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/id-scan.svg","pages":[{"title":"디지털 신분증 지갑 인증 API","sidebarTitle":"디지털 신분증 지갑 API","href":"/ko/standalone-apis/digital-id-wallets"},{"title":"디지털 ID 지갑 API 카탈로그","sidebarTitle":"디지털 ID 지갑 목록","openapi":"ko/openapi-25.json GET /v3/id-verification/wallets/","href":"/ko/standalone-apis/digital-id-wallet-catalog"},{"group":"인증 시작","pages":[{"title":"BankID 스웨덴 신원 인증 API","sidebarTitle":"BankID 스웨덴","openapi":"ko/openapi-25.json POST /v3/id-verification/wallets/bankid-se/","href":"/ko/api-reference/digital-id-wallets/bankid-se"},{"title":"Finnish Trust Network 신분증 인증 API","sidebarTitle":"Finnish Trust Network","openapi":"ko/openapi-25.json POST /v3/id-verification/wallets/ftn/","href":"/ko/api-reference/digital-id-wallets/ftn"},{"title":"Google Wallet 신분증 인증 API","sidebarTitle":"Google Wallet 신분증","openapi":"ko/openapi-25.json POST /v3/id-verification/wallets/google-wallet/","href":"/ko/api-reference/digital-id-wallets/google-wallet"},{"title":"MitID 개인 신원 인증 API","sidebarTitle":"MitID 개인","openapi":"ko/openapi-25.json POST /v3/id-verification/wallets/mitid/","href":"/ko/api-reference/digital-id-wallets/mitid"},{"title":"모바일 신분증 인증 API","sidebarTitle":"모바일 신분증","openapi":"ko/openapi-25.json POST /v3/id-verification/wallets/mobile-id/","href":"/ko/api-reference/digital-id-wallets/mobile-id"},{"title":"Smart-ID 신원 인증 API","sidebarTitle":"Smart-ID","openapi":"ko/openapi-25.json POST /v3/id-verification/wallets/smart-id/","href":"/ko/api-reference/digital-id-wallets/smart-id"},{"title":"iDIN 전체 신원 확인 API","sidebarTitle":"iDIN 전체 신원 확인","openapi":"ko/openapi-25.json POST /v3/id-verification/wallets/idin/","href":"/ko/api-reference/digital-id-wallets/idin"},{"title":"Auðkenni 신분증 인증 API","sidebarTitle":"Auðkenni","openapi":"ko/openapi-25.json POST /v3/id-verification/wallets/audkenni/","href":"/ko/api-reference/digital-id-wallets/audkenni"},{"title":"Bank iD 신분증 인증 API","sidebarTitle":"Bank iD","openapi":"ko/openapi-25.json POST /v3/id-verification/wallets/bankid-cz/","href":"/ko/api-reference/digital-id-wallets/bankid-cz"},{"title":"BankID Norway 신분증 인증 API","sidebarTitle":"BankID 노르웨이","openapi":"ko/openapi-25.json POST /v3/id-verification/wallets/bankid-no/","href":"/ko/api-reference/digital-id-wallets/bankid-no"},{"title":"Buypass ID 신분증 인증 API","sidebarTitle":"Buypass ID","openapi":"ko/openapi-25.json POST /v3/id-verification/wallets/buypass/","href":"/ko/api-reference/digital-id-wallets/buypass"},{"title":"ConnectID 신분증 인증 API","sidebarTitle":"ConnectID","openapi":"ko/openapi-25.json POST /v3/id-verification/wallets/connectid/","href":"/ko/api-reference/digital-id-wallets/connectid"},{"title":"Diia 신분증 인증 API","sidebarTitle":"Diia","openapi":"ko/openapi-25.json POST /v3/id-verification/wallets/diia/","href":"/ko/api-reference/digital-id-wallets/diia"},{"title":"EUDI 지갑 인증 API","sidebarTitle":"EUDI 지갑","openapi":"ko/openapi-25.json POST /v3/id-verification/wallets/eudi/","href":"/ko/api-reference/digital-id-wallets/eudi"},{"title":"에스토니아 ID 카드 인증 API","sidebarTitle":"에스토니아 ID 카드","openapi":"ko/openapi-25.json POST /v3/id-verification/wallets/idcard-ee/","href":"/ko/api-reference/digital-id-wallets/idcard-ee"},{"title":"FranceConnect 신분증 인증 API","sidebarTitle":"FranceConnect","openapi":"ko/openapi-25.json POST /v3/id-verification/wallets/franceconnect/","href":"/ko/api-reference/digital-id-wallets/franceconnect"},{"title":"Freja eID 신원 인증 API","sidebarTitle":"Freja eID","openapi":"ko/openapi-25.json POST /v3/id-verification/wallets/frejaid/","href":"/ko/api-reference/digital-id-wallets/frejaid"},{"title":"GOV.UK Wallet 신분증 인증 API","sidebarTitle":"GOV.UK Wallet","openapi":"ko/openapi-25.json POST /v3/id-verification/wallets/govuk-wallet/","href":"/ko/api-reference/digital-id-wallets/govuk-wallet"},{"title":"MojeID 신분증 인증 API","sidebarTitle":"MojeID","openapi":"ko/openapi-25.json POST /v3/id-verification/wallets/mojeid/","href":"/ko/api-reference/digital-id-wallets/mojeid"},{"title":"OneID 신원 인증 API","sidebarTitle":"OneID","openapi":"ko/openapi-25.json POST /v3/id-verification/wallets/oneid/","href":"/ko/api-reference/digital-id-wallets/oneid"},{"title":"Personalausweis Profile 2 신원 확인 API","sidebarTitle":"Personalausweis Profile 2","openapi":"ko/openapi-25.json POST /v3/id-verification/wallets/personalausweis/","href":"/ko/api-reference/digital-id-wallets/personalausweis"},{"title":"UAE PASS 인증 API","sidebarTitle":"UAE PASS","openapi":"ko/openapi-25.json POST /v3/id-verification/wallets/uae-pass/","href":"/ko/api-reference/digital-id-wallets/uae-pass"},{"title":"Vipps Plus 신분증 인증 API","sidebarTitle":"Vipps Plus","openapi":"ko/openapi-25.json POST /v3/id-verification/wallets/vipps/","href":"/ko/api-reference/digital-id-wallets/vipps"},{"title":"eParaksts mobile 신원 인증 API","sidebarTitle":"eParaksts mobile","openapi":"ko/openapi-25.json POST /v3/id-verification/wallets/eparaksts-mobile/","href":"/ko/api-reference/digital-id-wallets/eparaksts-mobile"},{"title":"gov.br 신분증 인증 API","sidebarTitle":"gov.br","openapi":"ko/openapi-25.json POST /v3/id-verification/wallets/govbr/","href":"/ko/api-reference/digital-id-wallets/govbr"},{"title":"itsme 신분증 인증 API","sidebarTitle":"itsme","openapi":"ko/openapi-25.json POST /v3/id-verification/wallets/itsme/","href":"/ko/api-reference/digital-id-wallets/itsme"}]},{"title":"디지털 ID 지갑 인증 결과 조회","sidebarTitle":"지갑 인증 결과 조회","openapi":"ko/openapi-25.json GET /v3/id-verification/wallets/verifications/{request_id}/","href":"/ko/standalone-apis/digital-id-wallet-result"},{"title":"디지털 자격 증명 월렛 응답 제출","sidebarTitle":"월렛 응답 제출","openapi":"ko/openapi-25.json POST /v3/id-verification/wallets/verifications/{request_id}/response/","href":"/ko/standalone-apis/digital-id-wallet-response"},{"title":"Smart-ID 및 Mobile-ID 인증 폴링","sidebarTitle":"지갑 인증 폴링","openapi":"ko/openapi-25.json POST /v3/id-verification/wallets/verifications/{request_id}/poll/","href":"/ko/standalone-apis/digital-id-wallet-poll"},{"title":"디지털 ID 지갑 인증 취소","sidebarTitle":"지갑 인증 취소","description":"Didit에서 대기 중인 독립형 디지털 ID 지갑 인증(standalone digital ID wallet verification)을 취소합니다.","openapi":"ko/openapi-25.json POST /v3/id-verification/wallets/verifications/{request_id}/cancel/","href":"/ko/standalone-apis/digital-id-wallet-cancel"}]},{"group":"문서 AI","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/document-ai.svg","pages":[{"title":"문서 AI API: 맞춤형 문서 데이터 추출","sidebarTitle":"문서 AI API","openapi":"ko/openapi-25.json POST /v3/document-ai/","href":"/ko/standalone-apis/document-ai"}]},{"group":"데이터베이스 검증 API","pages":[{"title":"데이터베이스 검증 API: 국가 ID 일치 확인","sidebarTitle":"데이터베이스 검증 API","description":"Didit 데이터베이스 검증 API. POST /v3/database-validation/로 100+ 국가 및 글로벌 소스에 신원 데이터를 1x1·2x2 waterfall 매칭으로 검증합니다. 호출 건당 과금.","openapi":"ko/openapi-25.json POST /v3/database-validation/","href":"/ko/standalone-apis/database-validation"}]},{"group":"데이터베이스 검증","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/driver-2.svg","pages":[{"group":"🇦🇷 아르헨티나","pages":[{"title":"아르헨티나 DNI 데이터 인증 API: 데이터 일치","sidebarTitle":"아르헨티나 DNI 데이터 인증 (RENAPER, 셀피 없음)","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/argentina/renaper-data"},{"title":"아르헨티나 DNI 검증(RENAPER) API","sidebarTitle":"아르헨티나 - DNI 검증(RENAPER)","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/argentina/renaper"},{"title":"아르헨티나 시민 데이터베이스 검증 API (AFIP)","sidebarTitle":"아르헨티나 시민 (AFIP)","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/argentina/citizens"},{"title":"아르헨티나 신용정보국 검증 API: ID 일치","sidebarTitle":"아르헨티나 신용정보국","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/argentina/credit-bureau"}]},{"group":"🇦🇺 호주","pages":[{"title":"호주 DVS 출생증명서 검증 API","sidebarTitle":"호주 - DVS - 출생증명서","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/australia/birth-certificate"},{"title":"호주 데이터베이스 검증 - Centrelink 카드 검증 API","sidebarTitle":"호주 - DVS - Centrelink 카드","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/australia/centrelink-card"},{"title":"호주 데이터베이스 검증 - DVS ImmiCard 인증 API","sidebarTitle":"호주 - DVS - ImmiCard","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/australia/immicard"},{"title":"호주 DVS 여행 문서 검증 API","sidebarTitle":"호주 - DVS - 여행 문서","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/australia/travel-document"},{"title":"호주 데이터베이스 검증 – DVS 개명 증명서 API","sidebarTitle":"호주 – DVS 개명 증명서","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/australia/change-of-name-certificate"},{"title":"호주 DVS 시민권 증명서 검증 API","sidebarTitle":"호주 - DVS 시민권 증명서","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/australia/citizenship-certificate"},{"title":"호주 결혼증명서 데이터베이스 검증 API - DVS","sidebarTitle":"호주 - DVS 결혼증명서","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/australia/marriage-certificate"},{"title":"호주 신용 조회 기관 검증 API: ID Match","sidebarTitle":"호주 신용 조회 기관","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/australia/credit-bureau"},{"title":"호주 사망 확인(BDM) API: 실시간 조회","sidebarTitle":"호주 사망 확인(BDM)","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/australia/death-check"},{"title":"호주 선거인명부 데이터베이스 검증 API: ID Match","sidebarTitle":"호주 선거인명부","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/australia/electoral-roll"},{"title":"호주 퇴직연금 및 급여 데이터베이스 검증 API","sidebarTitle":"호주 퇴직연금 및 급여","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/australia/superannuation-payroll"},{"title":"호주 VEVO 데이터베이스 검증 API: 실시간 조회","sidebarTitle":"호주 VEVO","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/australia/vevo"},{"title":"호주 운전면허 검증 API - DVS 데이터베이스 검증","sidebarTitle":"DVS - 호주 운전면허","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/australia/driver-licence"},{"title":"호주 Medicare 카드 DVS 검증 API - 데이터베이스 검증","sidebarTitle":"DVS - 호주 Medicare 카드","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/australia/medicare-card"},{"title":"호주 여권 검증 API - DVS 데이터베이스 검증 (ID Match)","sidebarTitle":"DVS - 호주 여권","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/australia/passport"},{"title":"호주 비자 데이터베이스 검증 API - DVS 데이터 대조","sidebarTitle":"DVS - 호주 비자","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/australia/visa"}]},{"title":"오스트리아 신용정보기관 검증 API: 데이터 일치 확인","sidebarTitle":"오스트리아 신용정보기관","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/austria/credit-bureau"},{"title":"볼리비아 CI 인증 API: 실시간 신분 조회","sidebarTitle":"볼리비아 - CI 인증","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/bolivia/cedula"},{"group":"🇧🇷 브라질","pages":[{"title":"브라질 Unico IDCloud(CPF + 셀피) 신분증 인증 API","sidebarTitle":"브라질 Unico IDCloud(CPF + 셀피)","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/brazil/unico-idcloud"},{"title":"브라질 CNH QR 코드 + 얼굴 대조 (Datavalid) API","sidebarTitle":"브라질 - CNH QR 코드 (Datavalid)","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/brazil/cnh-facial-qrcode"},{"title":"브라질 CPF + 얼굴 대조 (Datavalid) API: ID Match","sidebarTitle":"브라질 - CPF + 얼굴 대조 (Datavalid)","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/brazil/cpf-facial"},{"title":"브라질 CPF 상태 조회 API | 데이터베이스 검증","sidebarTitle":"브라질 - CPF 상태 조회","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/brazil/cpf"},{"title":"브라질 기업 파트너·이사(QSA) API","sidebarTitle":"브라질 기업 파트너·이사(QSA)","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/brazil/company-directors"},{"title":"브라질 기업 등기부 조회(CNPJ) API","sidebarTitle":"브라질 - 법인 등기부 조회(CNPJ)","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/brazil/company-registry"},{"title":"브라질 사망 여부 조회(CPF) API: 실시간 신원 조회","sidebarTitle":"브라질 - 사망 여부 확인(CPF)","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/brazil/death-check"},{"title":"브라질 연방 범죄 기록 검증 API","sidebarTitle":"브라질 연방 범죄 기록 (Polícia Federal)","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/brazil/antecedentes-criminais-pf"},{"title":"브라질 거주지 데이터베이스 검증 API: 신원 일치","sidebarTitle":"브라질 거주지","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/brazil/residential"},{"title":"브라질 납세자 번호(CPF/CNPJ) 데이터베이스 검증 API","sidebarTitle":"브라질 납세자 번호(CPF/CNPJ)","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/brazil/tax-registration"}]},{"title":"캄보디아 국민 ID 인증 API: 데이터 일치 확인","sidebarTitle":"캄보디아 국민 ID","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/cambodia/national-id"},{"group":"🇨🇦 캐나다","pages":[{"title":"캐나다 신용정보국(FINTRAC) 검증 API","sidebarTitle":"캐나다 신용정보국(FINTRAC)","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/canada/credit-bureau-fintrac"},{"title":"캐나다 신용정보기관 2(Non-FINTRAC) API: ID Match","sidebarTitle":"캐나다 신용정보기관 2(Non-FINTRAC)","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/canada/credit-bureau-2-non-fintrac"},{"title":"캐나다 거주지 인증 API: 신원 일치","sidebarTitle":"캐나다 거주지","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/canada/residential"}]},{"title":"칠레 RUT 검증 API: 실시간 데이터베이스 검증","sidebarTitle":"칠레 - RUT 검증","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/chile/rut"},{"group":"🇨🇳 중국","pages":[{"title":"중국 은행카드 데이터베이스 검증 API: 실시간 조회","sidebarTitle":"중국 은행카드","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/china/bank-card"},{"title":"중국 국가 신분증 인증 API: 신원 조회","sidebarTitle":"중국 국가 신분증","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/china/national-id"},{"title":"중국 여권 인증 API: 실시간 조회","sidebarTitle":"중국 여권 인증","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/china/passport-verification"},{"title":"중국 전화번호 인증 API: 실시간 신원 조회","sidebarTitle":"중국 전화번호","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/china/phone"}]},{"group":"🇨🇴 콜롬비아","pages":[{"title":"콜롬비아 Cédula 인증 API - 데이터베이스 검증","sidebarTitle":"콜롬비아 - Cédula 인증","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/colombia/cedula"},{"title":"Migración Colombia 외국인 신분 상태 API (콜롬비아)","sidebarTitle":"콜롬비아 - Migración Colombia 외국인 상태","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/colombia/migracion"}]},{"title":"코스타리카 Cédula 데이터베이스 검증 API: 데이터 일치 확인","sidebarTitle":"코스타리카 Cédula 검증","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/costa-rica/cedula"},{"group":"🇩🇰 덴마크","pages":[{"title":"덴마크 소비자 2 데이터베이스 검증 API: 신원 일치","sidebarTitle":"덴마크 소비자 2","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/denmark/consumer-2"},{"title":"덴마크 국가 신분증 인증 API: 데이터 대조","sidebarTitle":"덴마크 국가 신분증","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/denmark/national-id"}]},{"title":"도미니카 공화국 Cédula 데이터베이스 검증 API","sidebarTitle":"도미니카 공화국 Cédula","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/dominican-republic/cedula"},{"title":"에콰도르 Cédula 검증 API: 실시간 데이터베이스 조회","sidebarTitle":"에콰도르 - Cédula 검증","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/ecuador/cedula"},{"title":"엘살바도르 DUI 인증 API: 신원 조회","sidebarTitle":"엘살바도르 - DUI 인증","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/el-salvador/dui"},{"group":"🇫🇮 핀란드","pages":[{"title":"Finland 소비자 2 인증 API: 신원 일치 확인","sidebarTitle":"Finland 소비자 2","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/finland/consumer-2"},{"title":"핀란드 국가 신분증 데이터베이스 검증 API: 데이터 일치","sidebarTitle":"핀란드 국가 신분증","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/finland/national-id"}]},{"group":"🇫🇷 프랑스","pages":[{"title":"프랑스 전화번호 인증 API: 실시간 신원 조회","sidebarTitle":"프랑스 전화번호","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/france/phone"},{"title":"프랑스 거주지 데이터베이스 검증 API: 신원 일치","sidebarTitle":"프랑스 거주지","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/france/residential"},{"title":"프랑스 유틸리티 인증 API: 실시간 조회","sidebarTitle":"프랑스 유틸리티","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/france/utility"}]},{"group":"🇩🇪 독일","pages":[{"title":"독일 신용평가기관 인증 API: 데이터 일치","sidebarTitle":"독일 신용평가기관","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/germany/credit-bureau"},{"title":"독일 데이터베이스 검증 API: Phone 2 실시간 조회","sidebarTitle":"독일 Phone 2","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/germany/phone-2"}]},{"group":"🌐 글로벌","pages":[{"title":"데이터베이스 검증 API - Global Core Intelligence Service","sidebarTitle":"Global - Core Intelligence Service","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/global/intelligence-service"},{"title":"글로벌 신원 정보 보강 검증 API","sidebarTitle":"글로벌 - 신원 정보 보강","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/global/identity-enrichment"},{"title":"글로벌 SIM 스왑 검증 API: Telco Match","sidebarTitle":"글로벌 - SIM 스왑","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/global/swap"}]},{"group":"🇬🇹 과테말라","pages":[{"title":"과테말라 DPI + 얼굴 대조(RENAP) API: ID Match","sidebarTitle":"과테말라 DPI + 얼굴 대조(RENAP)","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/guatemala/dpi-facial"},{"title":"과테말라 DPI 검증 API: 실시간 조회","sidebarTitle":"과테말라 DPI 검증","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/guatemala/dpi"}]},{"title":"온두라스 DNI 검증 API: 실시간 조회","sidebarTitle":"온두라스 DNI 검증","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/honduras/dni"},{"group":"🇮🇳 인도","pages":[{"title":"인도 Aadhaar(UIDAI) 데이터베이스 검증 API: 데이터 일치","sidebarTitle":"인도 Aadhaar (UIDAI)","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/india/aadhaar"},{"title":"인도 운전면허(RTO) 검증 API","sidebarTitle":"인도 운전면허(RTO)","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/india/drivers-licence"},{"title":"인도 유권자 등록(EPIC) 데이터베이스 검증 API (ECI)","sidebarTitle":"인도 EPIC (ECI)","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/india/epic-voter-s-registration"},{"title":"인도 PAN(영구 계좌 번호, ITD) API","sidebarTitle":"인도 PAN(ITD)","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/india/pan-permanent-account-number"}]},{"title":"인도네시아 주민등록증 데이터베이스 검증 API","sidebarTitle":"인도네시아 주민등록증","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/indonesia/residential-identity-card"},{"group":"🇮🇹 이탈리아","pages":[{"title":"이탈리아 신용정보 조회 API: 헤더 일치","sidebarTitle":"이탈리아 신용정보기관","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/italy/credit-bureau"},{"title":"이탈리아 거주지 데이터베이스 검증 API: 신원 조회","sidebarTitle":"이탈리아 거주지","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/italy/residential"}]},{"title":"케냐 국가 신분증 검증 API: 신원 조회","sidebarTitle":"케냐 국가 신분증","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/kenya/national-id"},{"title":"말레이시아 국민 ID 검증 API: 데이터베이스 대조","sidebarTitle":"말레이시아 국민 ID","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/malaysia/national-id"},{"group":"🇲🇽 멕시코","pages":[{"title":"멕시코 CURP 인증 API: 실시간 신원 조회","sidebarTitle":"멕시코 - CURP 인증","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/mexico/curp"},{"title":"멕시코 INE 신분증 유효성 검증 API","sidebarTitle":"멕시코 INE 유효성 검증","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/mexico/ine-vigencia"}]},{"title":"네덜란드 거주지 데이터베이스 검증 API: ID 대조","sidebarTitle":"네덜란드 거주지","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/netherlands/residential"},{"group":"🇳🇿 뉴질랜드","pages":[{"title":"뉴질랜드 출생 기록 데이터베이스 검증 API - DIA: ID Match","sidebarTitle":"DIA - 뉴질랜드 출생 기록","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/new-zealand/births"},{"title":"뉴질랜드 시민권 인증 API - DIA","sidebarTitle":"DIA - 뉴질랜드 시민권","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/new-zealand/citizenship"},{"title":"뉴질랜드 여권 인증 API - DIA 데이터베이스 검증","sidebarTitle":"DIA - 뉴질랜드 여권","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/new-zealand/passport"},{"title":"뉴질랜드 사망 확인(BDM) API: 실시간 조회","sidebarTitle":"뉴질랜드 사망 확인(BDM)","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/new-zealand/death-check"},{"title":"뉴질랜드 운전면허증(NZTA) 인증 API","sidebarTitle":"뉴질랜드 운전면허증(NZTA)","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/new-zealand/drivers-licence"}]},{"group":"🇳🇬 나이지리아","pages":[{"title":"나이지리아 은행 확인 번호(BVN) API","sidebarTitle":"나이지리아 은행 확인 번호(BVN)","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/nigeria/bank-verification-number"},{"title":"나이지리아 운전면허증(FRSC) 검증 API","sidebarTitle":"나이지리아 운전면허증(FRSC)","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/nigeria/drivers-license"},{"title":"나이지리아 국제 여권(NIS) API: ID 일치 확인","sidebarTitle":"나이지리아 국제 여권(NIS)","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/nigeria/passport"},{"title":"나이지리아 국민 신원번호(NIMC) 검증 API","sidebarTitle":"나이지리아 국민 신원번호(NIMC)","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/nigeria/national-id"},{"title":"나이지리아 국가 신분증 + 셀피(NIMC) 신분증 인증 API","sidebarTitle":"나이지리아 국가 신분증 + 셀피(NIMC)","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/nigeria/national-id-facial"}]},{"title":"노르웨이 거주지 데이터베이스 검증 API: 신원 일치","sidebarTitle":"노르웨이 거주지","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/norway/residential"},{"group":"🇵🇦 파나마","pages":[{"title":"파나마 Cédula 생체 얼굴 대조 API","sidebarTitle":"파나마 Cédula 생체 얼굴 대조 (SIB Plus, 상위 등급)","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/panama/sib-plus"},{"title":"파나마 시데울라 데이터베이스 검증 및 얼굴 대조 API (SIB)","sidebarTitle":"파나마 - 시데울라 얼굴 대조 (SIB)","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/panama/sib"}]},{"title":"파라과이 CI 검증 API: 실시간 신원 조회","sidebarTitle":"파라과이 - CI 검증","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/paraguay/cedula"},{"group":"🇵🇪 페루","pages":[{"title":"페루 DNI 인증 API: 실시간 신원 조회","sidebarTitle":"페루 - DNI 인증","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/peru/dni"},{"title":"페루 납세자 번호 데이터베이스 검증 API (SUNAT)","sidebarTitle":"페루 세금 등록 (SUNAT)","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/peru/tax-registration"}]},{"title":"필리핀 거주지 데이터베이스 검증 API: ID 대조","sidebarTitle":"필리핀 거주지","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/philippines/residential"},{"group":"🇸🇬 싱가포르","pages":[{"title":"싱가포르 신용정보 기관 데이터베이스 검증 API: ID 대조","sidebarTitle":"싱가포르 신용정보 기관","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/singapore/credit-bureau"},{"title":"싱가포르 데이터베이스 검증 API: 신원 조회","sidebarTitle":"싱가포르 공과금","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/singapore/utility"}]},{"group":"🇿🇦 남아프리카 공화국","pages":[{"title":"남아프리카공화국 은행 계좌 명의인 확인 API","sidebarTitle":"남아프리카공화국 - 은행 계좌 명의인 확인","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/south-africa/bank-account-holder"},{"title":"남아프리카공화국 기업 이사 조회 API","sidebarTitle":"남아프리카공화국 - 기업 이사 조회","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/south-africa/company-directors"},{"title":"남아프리카공화국 법인 등기부 조회 API","sidebarTitle":"남아프리카공화국 - 법인 등기부 조회","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/south-africa/company-registry"},{"title":"남아프리카공화국 연락 가능성 조회 API: ID Match","sidebarTitle":"남아프리카공화국 - 연락 가능성 조회","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/south-africa/contactability"},{"title":"남아프리카공화국 - 얼굴 기반 범죄 경력 조회 API","sidebarTitle":"남아프리카공화국 - 얼굴 기반 범죄 조회","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/south-africa/criminal-face-screening"},{"title":"남아프리카공화국 DHA 지문 대조 API: 신분증 대조","sidebarTitle":"남아프리카공화국 - DHA 지문 대조","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/south-africa/dha-fingerprint-match"},{"title":"남아프리카공화국 DHA 사진 조회 검증 API","sidebarTitle":"남아프리카공화국 DHA 사진 조회","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/south-africa/dha-photo"},{"title":"남아프리카공화국 운전면허 검증 API","sidebarTitle":"남아프리카공화국 운전면허 검증","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/south-africa/drivers-license"},{"title":"남아프리카공화국 - 사기 방지 스크리닝 API","sidebarTitle":"남아프리카공화국 - 사기 방지 스크리닝","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/south-africa/fraud-prevention"},{"title":"남아프리카공화국 개인 이사직 조회 API","sidebarTitle":"남아공 - 개인 이사직 조회","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/south-africa/person-directorships"},{"title":"남아프리카공화국 난민 파일 검증 API","sidebarTitle":"남아프리카공화국 - 난민 파일 검증","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/south-africa/refugee"},{"title":"남아프리카공화국 차량 소유권 확인 API","sidebarTitle":"남아프리카 차량 소유권 확인","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/south-africa/vehicle-ownership"},{"title":"남아프리카공화국 국민 ID(DHA) 검증 API","sidebarTitle":"남아프리카 국민 ID(DHA)","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/south-africa/national-id"}]},{"title":"스페인 DNI/NIE 검증 API: 실시간 조회","sidebarTitle":"스페인 - DNI/NIE 검증","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/spain/dni"},{"group":"🇸🇪 스웨덴","pages":[{"title":"스웨덴 국가 ID 데이터베이스 검증 API: 신원 일치","sidebarTitle":"스웨덴 국가 ID","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/sweden/national-id"},{"title":"스웨덴 전화번호 인증 API: 실시간 데이터베이스 검증","sidebarTitle":"스웨덴 전화번호","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/sweden/phone"}]},{"title":"스위스 신용정보국 데이터베이스 검증 API","sidebarTitle":"스위스 신용정보국","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/switzerland/credit-bureau"},{"title":"태국 국가 신분증 데이터베이스 검증 API: 데이터 일치 확인","sidebarTitle":"태국 국가 신분증","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/thailand/national-id"},{"group":"🇬🇧 영국","pages":[{"title":"영국 신용정보기관 데이터베이스 검증 API","sidebarTitle":"영국 신용정보기관","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/united-kingdom/credit-bureau"},{"title":"영국 금융 서비스 데이터베이스 검증 API","sidebarTitle":"영국 금융 서비스","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/united-kingdom/financial-services"},{"title":"영국 전화번호 인증 2 API: 데이터 대조","sidebarTitle":"영국 전화번호 2","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/united-kingdom/phone-2"},{"title":"영국 거주지 데이터베이스 검증 API","sidebarTitle":"영국 거주지","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/united-kingdom/residential"}]},{"group":"🇺🇸 미국","pages":[{"title":"미국 신용정보기관 검증 API","sidebarTitle":"미국 - 신용정보기관","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/united-states/credit-bureau"},{"title":"미국 사망 기록 확인(SSDMF) API: 데이터 매칭","sidebarTitle":"미국 - 사망 기록 확인(SSDMF)","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/united-states/death-check"},{"title":"미국 금융 서비스 데이터베이스 검증 API","sidebarTitle":"미국 - 금융 서비스","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/united-states/financial-services"},{"title":"미국 데이터베이스 검증 API: 전화번호 2 데이터 일치","sidebarTitle":"미국 - 전화번호 2","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/united-states/phone-2"},{"title":"미국 거주지 데이터베이스 검증 API","sidebarTitle":"미국 - 거주지","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/united-states/residential"}]},{"title":"우루과이 CI 검증 API - 실시간 신분 조회","sidebarTitle":"우루과이 - CI 검증","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/uruguay/cedula"},{"title":"베네수엘라 Cédula 검증 API: 신원 일치 확인","sidebarTitle":"베네수엘라 - Cédula 검증","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/venezuela/cedula"},{"title":"잠비아 NRC(세금 등록) 데이터베이스 검증 API","sidebarTitle":"잠비아 NRC(세금 등록)","api":"POST /v3/database-validation/","href":"/ko/api-reference/database-validation/zambia/national-id"}]},{"group":"생체 인식 및 얼굴","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/liveness.svg","pages":[{"title":"패시브 라이브니스 API: 딥페이크 감지","sidebarTitle":"패시브 라이브니스","openapi":"ko/openapi-25.json POST /v3/passive-liveness/","href":"/ko/standalone-apis/passive-liveness"},{"title":"얼굴 대조 API: 1:1 얼굴 비교","sidebarTitle":"얼굴 대조","openapi":"ko/openapi-25.json POST /v3/face-match/","href":"/ko/standalone-apis/face-match"},{"title":"얼굴 검색 API: 1:N 얼굴 중복 제거 및 사기 조직 탐지","sidebarTitle":"얼굴 검색","openapi":"ko/openapi-25.json POST /v3/face-search/","href":"/ko/standalone-apis/face-search"},{"title":"연령 추정 API: 셀피 기반 연령 확인","sidebarTitle":"연령 추정 API","openapi":"ko/openapi-25.json POST /v3/age-estimation/","href":"/ko/standalone-apis/age-estimation"}]},{"group":"컴플라이언스 및 위험","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/aml-screening.svg","pages":[{"title":"AML 스크리닝 API: 제재, PEP 및 감시 목록","sidebarTitle":"AML 스크리닝 API","openapi":"ko/openapi-25.json POST /v3/aml/","href":"/ko/standalone-apis/aml-screening"},{"title":"AML 데이터셋 최신성 API","sidebarTitle":"AML 데이터셋 최신성 조회","openapi":"ko/openapi-25.json GET /v3/aml/dataset-freshness/","href":"/ko/standalone-apis/aml-dataset-freshness"},{"title":"사기 확인 API (Fraud Check API)","openapi":"ko/openapi-25.json POST /v3/fraud/checks/","href":"/ko/standalone-apis/fraud-check"},{"title":"사기 검사 계획 및 요금 추정","openapi":"ko/openapi-25.json POST /v3/fraud/checks/plan/","href":"/ko/standalone-apis/fraud-check-plan"},{"title":"Fraud Check 결과 조회","openapi":"ko/openapi-25.json GET /v3/fraud/checks/{check_id}/","href":"/ko/standalone-apis/fraud-check-result"}]},{"group":"기기 및 IP 분석","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/ip-analysis.svg","pages":[{"title":"IP 위험 API: 위치, VPN 및 데이터센터 신호","sidebarTitle":"IP 위험 API","openapi":"ko/openapi-25.json POST /v3/ip/risk/","href":"/ko/standalone-apis/ip-risk"}]},{"group":"KYB 등기부","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/businesses.svg","pages":[{"title":"KYB 레지스트리 API: 기업 검색 및 선택","sidebarTitle":"KYB 레지스트리","href":"/ko/standalone-apis/kyb-registry"},{"title":"KYB 레지스트리 검색 API - 기업 검색","sidebarTitle":"KYB 레지스트리 검색","openapi":"ko/openapi-25.json POST /v3/kyb/search/","href":"/ko/standalone-apis/kyb-registry-search"},{"title":"기업 확인(KYB) 레지스트리 선택 API: 기업 프로필 조회","sidebarTitle":"KYB 레지스트리 선택","openapi":"ko/openapi-25.json POST /v3/kyb/select/","href":"/ko/standalone-apis/kyb-registry-select"},{"title":"기업 확인(KYB) 주주 조회 API","sidebarTitle":"KYB 주주 조회","openapi":"ko/openapi-25.json POST /v3/kyb/shareholders/","href":"/ko/standalone-apis/kyb-registry-shareholders"},{"title":"KYB 레지스트리 UBO API: 최종 실소유자 조회","sidebarTitle":"KYB 레지스트리 UBO","openapi":"ko/openapi-25.json POST /v3/kyb/ubo/","href":"/ko/standalone-apis/kyb-registry-ubo"}]},{"group":"이메일 인증","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/sms-tracking.svg","pages":[{"title":"이메일 인증 API: OTP 및 위험 점수","sidebarTitle":"개요","href":"/ko/standalone-apis/email-verification"},{"title":"이메일 OTP 전송 API: 이메일 인증 코드 발송","sidebarTitle":"이메일 코드 발송","openapi":"ko/openapi-25.json POST /v3/email/send/","href":"/ko/standalone-apis/email-send"},{"title":"이메일 OTP 검증 API: 이메일 코드 확인","sidebarTitle":"이메일 코드 확인","openapi":"ko/openapi-25.json POST /v3/email/check/","href":"/ko/standalone-apis/email-check"},{"title":"이메일 위험 API: 전달 가능성 및 유출 신호","sidebarTitle":"이메일 위험 API","openapi":"ko/openapi-25.json POST /v3/email/risk/","href":"/ko/standalone-apis/email-risk"}]},{"group":"전화번호 인증","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/phone-verification.svg","pages":[{"title":"전화번호 인증 API: SMS OTP 및 위험 신호","sidebarTitle":"개요","href":"/ko/standalone-apis/phone-verification"},{"title":"전화번호 인증 API: SMS 일회용 코드 발송","sidebarTitle":"인증 코드 발송","openapi":"ko/openapi-25.json POST /v3/phone/send/","href":"/ko/standalone-apis/phone-send"},{"title":"전화번호 인증 코드 확인 API: SMS OTP 검증","sidebarTitle":"전화번호 코드 확인","openapi":"ko/openapi-25.json POST /v3/phone/check/","href":"/ko/standalone-apis/phone-check"},{"title":"전화번호 위험 API: 통신사 및 사기 감지 신호","sidebarTitle":"전화번호 위험 API","openapi":"ko/openapi-25.json POST /v3/phone/risk/","href":"/ko/standalone-apis/phone-risk"}]},{"group":"은행 계좌 인증","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/billing.svg","pages":[{"title":"계좌 확인 API: 지급 계좌 검증","sidebarTitle":"계좌 확인 API","openapi":"ko/openapi-25.json POST /v3/bank/account-check/","href":"/ko/standalone-apis/bank-account-check"}]}]},{"tab":"사용자 인증","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/user-verifications.svg","pages":[{"title":"사용자 인증","href":"/ko/core-technology/liveness/overview"}]},{"tab":"기업 확인","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/business-verifications.svg","pages":[{"title":"기업 확인","href":"/ko/business-verification/overview"}]},{"tab":"거래 모니터링","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/transactions.svg","pages":[{"title":"거래 모니터링","href":"/ko/transaction-monitoring/overview"}]},{"tab":"변경 내역","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/calendar.svg","pages":[{"title":"변경 내역","href":"/ko/changelog"}]}],"global":{"anchors":[{"anchor":"API 레퍼런스","icon":"code","href":"/ko/api-reference/overview"},{"anchor":"Business Console","icon":"gauge","href":"https://business.didit.me"},{"anchor":"OpenAPI 사양","icon":"file-code","href":"https://docs.didit.me/ko/openapi-25.json"},{"anchor":"연동 프롬프트","icon":"wand-magic-sparkles","href":"/ko/integration/integration-prompt"},{"anchor":"MCP 서버","icon":"plug","href":"/ko/integration/mcp/overview"},{"anchor":"에이전트 스킬","icon":"robot","href":"https://github.com/didit-protocol/skills"}]}},{"language":"zh","navbar":{"links":[{"icon":"comment-dots","href":"https://help.didit.me","label":"支持"},{"icon":"signal","href":"https://status.didit.me","label":"状态"}],"primary":{"type":"button","label":"登录","href":"https://business.didit.me"}},"pages":[{"title":"zh","href":"/zh/standalone-apis/document-ai"}]},{"language":"ar","navbar":{"links":[{"icon":"comment-dots","href":"https://help.didit.me","label":"الدعم"},{"icon":"signal","href":"https://status.didit.me","label":"الحالة"}],"primary":{"type":"button","label":"تسجيل الدخول","href":"https://business.didit.me"}},"pages":[{"title":"ar","href":"/ar/standalone-apis/document-ai"}]},{"language":"hi","navbar":{"links":[{"icon":"comment-dots","href":"https://help.didit.me","label":"सहायता"},{"icon":"signal","href":"https://status.didit.me","label":"स्थिति"}],"primary":{"type":"button","label":"साइन इन करें","href":"https://business.didit.me"}},"pages":[{"title":"hi","href":"/hi/standalone-apis/document-ai"}]}]},"basePath":"","title":"문서 AI API: 맞춤형 문서 데이터 추출 - Didit Docs","buildId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","deploymentId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CBsVopKK.js","utils-DZAk68jJ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D32AYZrP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D_A5_cny.js","snippetPresets-xNRfS9th.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BIB25-tq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CydJ4w4j.js","shallow-CYPBeQSG.js","getApiPlaygroundDisplay-A5xJVBOu.js","CodeSnippet-BVRTgi3m.js","CodeSnippets-DjD6BSlt.js","Page-Dr40SSJq.js","getPastedJson-D4V4JyrR.js","icon-uhcnG22T.js","MethodPill-CM-ZQdGH.js","DuplicateIcon-B_WnOiNf.js","createIcon-CJsb8utt.js","DynamicMarkdown-D-2HDKEp.js","SectionHeading-KP5xmMgQ.js","axios-vUo_bRtp.js","Markdown-D_k0dg6k.js","clsx-DK3K4Z1S.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DE3EVdvd.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-fN9H9n9g.js"]}