메인 콘텐츠로 건너뛰기
PATCH
curl
검사 전체가 아닌 개별 일치 항목에 대한 결정을 내리려면 AML 히트 상태 업데이트를 사용하십시오. 스크리닝 결과와 상태가 생성되는 방식은 AML 스크리닝을 참조하십시오.

인증

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"

쿼리 매개변수

node_id
string

업데이트할 AML 확인의 워크플로 그래프 노드 ID입니다. 세션에서 둘 이상의 AML 단계를 실행한 경우에만 필요합니다. 본문의 node_id보다 우선합니다.

예시:

"feature_aml_1"

본문

application/json
status
enum<string>
필수

AML 검사의 새 상태입니다.

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

"Approved"

node_id
string

쿼리 파라미터 대신 사용할 수 있는 AML 확인의 워크플로 그래프 노드 ID입니다.

예시:

"feature_aml_1"

응답

설정된 AML 검사 상태입니다(이미 이 값을 가지고 있던 경우 변경되지 않음).

message
string
필수

항상 AML status updated successfully입니다.

status
enum<string>
필수

현재 AML 검사의 상태입니다.

사용 가능한 옵션:
Not Finished,
Approved,
Declined,
In Review,
Resub Requested
previous_status
enum<string>
필수

호출 전 상태입니다. 변경 사항이 없는 경우 status와 같습니다.

사용 가능한 옵션:
Not Finished,
Approved,
Declined,
In Review,
Resub Requested
마지막 수정일 2026년 11월 7일