메인 콘텐츠로 건너뛰기
PATCH
curl
필드 키는 워크플로에서 문서에 대해 구성한 키입니다. 문서와 필드를 설정하는 방법은 Document AI를, 세션 결정에서 결과가 표시되는 위치는 Document AI 보고서를 참고하십시오.

인증

x-api-key
string
header
필수

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 를 참고하십시오.

경로 매개변수

sessionId
string<uuid>
필수

인증 세션의 UUID(POST /v3/session/에서 반환된 session_id)입니다. 사용자 인증(KYC) 및 기업 확인(KYB) 세션 ID를 모두 지원하며, 서버는 두 세션 유형 전체에서 ID를 확인합니다. 올바른 형식의 UUID여야 합니다. 형식이 잘못된 값은 경로와 일치하지 않아 HTML 404를 반환합니다.

예시:

"11111111-2222-3333-4444-555555555555"

documentUuid
string<uuid>
필수

Document AI 문서의 UUID(GET /v3/session/{sessionId}/decision/의 document_ai_documents[].items[].uuid)입니다. 경로의 세션에 속해 있어야 합니다.

예시:

"44444444-5555-6666-7777-888888888888"

본문

application/json
extracted_data
object

필드 키(해당 문서에 대해 구성한 키)와 수정된 값입니다. JSON 객체여야 하며, 저장된 데이터에 키별로 병합됩니다. null을 전송하면 400이 반환되므로 생략하십시오.

예시:
status
enum<string>

문서의 새 검토 상태입니다.

사용 가능한 옵션:
Approved,
Declined,
In Review,
Not Finished
예시:

"Approved"

응답

문서가 업데이트되었습니다. 병합 후의 문서를 반환합니다.

uuid
string<uuid>
필수

문서 식별자입니다.

document_key
string
필수

이 업로드에 해당하는 구성된 문서입니다.

original_filename
string | null
필수

문서가 업로드된 파일 이름입니다.

file_url
string | null
필수

업로드된 파일의 저장 경로입니다. 다운로드 링크가 아니며, 파일을 다운로드하려면 세션 결정에서 사전 서명된 file_url을 읽으십시오.

status
enum<string>
필수

문서의 검토 상태입니다.

사용 가능한 옵션:
Not Finished,
Approved,
Declined,
In Review,
Resub Requested
extracted_data
object | null
필수

병합 후 추출된 모든 필드이며, 필드 키를 키로 가집니다.

마지막 수정일 2026년 11월 7일