결과 시뮬레이션(Test Mock)
샌드박스에서는 실제 생체 인식 캡처에 의존하지 않고 프로세스 결과를 시뮬레이션할 수 있습니다. 프로세스 생성 요청 본문에 expected_result 필드를 추가하세요 — 나머지 통합 과정(SDK 렌더링, 생체 인식 캡처, 프로세스 조회)은 실제 flow와 완전히 동일하게 유지됩니다.
모의(mock)는 생체 인식 캡처 단계를 건너뛰지 않습니다. 사용자(또는 테스트 스크립트)는 여전히 일반적인 flow를 완료해야 합니다 — 달라지는 점은, 완료되면 프로세스가 실제 평가 결과 대신 expected_result에 정의된 값을 반환한다는 것입니다.
각 flow는 설정 방식에 따라 아래 두 가지 형식 중 하나만 허용합니다:
| 형식 | 사용 시점 |
|---|---|
id_cloud_one_result | 단일 결과(승인, 거부, 고위험 등)를 반환하는 flow |
authentication_info | 개별 신호(UnicoId, Trust, Liveness, IdAge, IdFace...)를 반환하는 flow |
flow와 일치하지 않는 형식을 전송하거나 두 형식을 동시에 전송하면 오류가 발생합니다 — 오류를 참조하세요.
엔드포인트
| 환경 | URL |
|---|---|
| 샌드박스 | POST https://api.idcloud.uat.unico.app/client/v1/process |
모의(mock)는 샌드박스에서만 사용할 수 있습니다. 프로덕션에서는 expected_result 필드가 거부됩니다.
단일 결과 — id_cloud_one_result
flow가 단일 승인 형태의 결과를 반환하는 경우 이를 사용하세요.
본문 매개변수
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
expected_result.id_cloud_one_result | string | 예 | 시뮬레이션할 단일 결과입니다. flow가 실제로 생성하는 결과여야 합니다 — flow 설정에서 인식되는 결과를 확인하세요. |