메인 콘텐츠로 건너뛰기
PATCH
Python

인증

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>
필수

기업 확인(KYB) 세션의 UUID입니다. 해당 API 키의 애플리케이션에 속해 있어야 합니다.

예시:

"33333333-4444-5555-6666-777777777777"

draftId
string<uuid>
필수

당사자 초안의 UUID(생성 시 반환된 draft_id).

예시:

"5b0d7a52-9d3e-4f0c-8c6a-0e5f3a1b2c4d"

쿼리 매개변수

node_id
string

KYB 단계의 워크플로 노드입니다. 워크플로에 둘 이상의 KYB 노드가 있는 경우에만 필요하며, 기본적으로 Didit은 세션 자체의 노드를 사용합니다.

본문

application/json

당사자 필드의 모든 하위 집합입니다. 수정 사항은 저장된 임시 초안에 병합되며 병합된 당사자 정보는 전체적으로 유효성이 검증되므로, 수정 전에 제출할 수 있었던 초안은 수정 후에도 제출할 수 있습니다.

entity_type
enum<string>

해당 당사자가 개인인지 기업인지 여부입니다.

사용 가능한 옵션:
person,
company
full_name
string

개인의 성명입니다. 이 값을 전송하거나, first_name 및 last_name을 전송하십시오.

Maximum string length: 255
first_name
string
Maximum string length: 128
last_name
string
Maximum string length: 128
role
enum<string>

해당 당사자가 보유한 역할. roles와 서로 바꿔 사용할 수 있으며, 둘 다 전송되면 병합됩니다.

사용 가능한 옵션:
director,
non_executive_director,
secretary,
chairman,
ubo,
shareholder,
representative,
founder,
legal_advisor,
authorized_signatory,
trustee,
beneficiary,
settlor,
protector,
company_officer,
investor,
other
roles
enum<string>[]

해당 주체가 보유한 모든 역할입니다. 개인은 최소 하나의 역할(여기 또는 role)이 필요합니다.

사용 가능한 옵션:
director,
non_executive_director,
secretary,
chairman,
ubo,
shareholder,
representative,
founder,
legal_advisor,
authorized_signatory,
trustee,
beneficiary,
settlor,
protector,
company_officer,
investor,
other
position
string

개인의 직책입니다.

Maximum string length: 128
date_of_birth
string<date> | null
company_name
string

기업 당사자의 이름입니다. entity_type이 company인 경우 필수입니다.

Maximum string length: 255
registration_number
string

기업 당사자의 등록번호입니다.

Maximum string length: 100
email
string<email>

인증 링크가 전송되는 위치입니다. 당사자가 인증을 완료해야 할 때 필수이며, 이는 워크플로의 역할 설정 및 소유 구조 임계값에 따라 결정됩니다.

ownership_percent
number | null

해당 주체가 보유한 기업의 지분입니다.

nationality
string

개인의 국적 또는 기업의 설립 국가입니다. 모든 당사자에게 필수입니다.

Maximum string length: 100
phone_number
string
Maximum string length: 32
custom_fields
object

워크플로에서 정의된 추가 필드입니다.

skip_verification
boolean
기본값:false

이 당사자의 인증 건너뛰기를 요청합니다. 워크플로의 주요 인물 설정에서 해당 당사자의 역할에 건너뛰기가 허용된 경우에만 적용됩니다.

응답

초안이 업데이트되었습니다.

draft_id
string<uuid>
필수
created_at
string<date-time>
필수
updated_at
string<date-time>
필수
party
object
필수
마지막 수정일 2026년 11월 7일