---
title: 결과 시뮬레이션(Test Mock)
description: 프로세스 생성 시 expected_result를 사용하여, 실제 생체 인식 캡처 없이 샌드박스에서 프로세스 결과를 시뮬레이션합니다.
canonical: https://developer.unico.io/ko/developers/start/test-mock
locale: ko
generated_by: markdown-export
---

- [/ko/](/ko/)
- [시작하기](/ko/developers/start/)
- 결과 시뮬레이션

**이 페이지에서# 결과 시뮬레이션(Test Mock)

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

환경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 설정에서 인식되는 결과를 확인하세요.
### 예제​

```
curl -X POST https://api.idcloud.uat.unico.app/client/v1/process \  -H "Authorization: Bearer $TOKEN" \  -H "Content-Type: application/json" \  -d '{    "expected_result": {      "id_cloud_one_result": "PROCESS_RESULT_APPROVED"    }    // ... 나머지 매개변수는 실제 프로세스 생성 호출에서 사용하는 것과 동일합니다  }'
```

### 응답 (200 OK)​

```
{  "process": {    "id": "53060f52-f146-4c12-a234-5bb5031f6f5b",    "state": "PROCESS_STATE_FINISHED",    "result": "PROCESS_RESULT_OK",    "flow": "your-sandbox-flow",    "simulated": true,    "capacities": ["PROCESS_CAPACITY_IDCHECK"],    "person": { "duiType": "DUI_TYPE_BR_CPF", "duiValue": "12345678909" }  }}
```

`simulated: true`는 이 프로세스가 실제 평가가 아닌 시뮬레이션된 결과를 가짐을 나타냅니다.
`id_cloud_one_result`의 가능한 값은 [결과 해석하기](/ko/developers/start/flows#interpreting-results)에 문서화된 프로세스 결과 값과 동일합니다 — `flow`가 실제로 인식하는 결과만 전송하세요.
개별 신호 — authentication_info
`flow`가 단일 결과 대신 개별 신호를 반환하는 경우 이를 사용하세요.
**`flow`가 일반적으로 반환하는 모든 신호는 `authentication_info`에 포함되어야 합니다.** 일부만 전송하면 거부됩니다 — 신호 하나만 모의(mock)하고 나머지는 실제 평가에 맡길 수 없습니다.
`trust_result` 대 `identity_fraudsters_result``trust_result`와 `identity_fraudsters_result`는 동일한 신호(신원 사기 표시)를 나타냅니다: `trust_result`는 부정적인 측면을, `identity_fraudsters_result`는 긍정적인 측면을 다룹니다. 시뮬레이션하려는  결과에 맞는 것을 사용하세요.
각 필드의 가능한 값은 [authenticationInfo의 기능별 결과](/ko/developers/api-reference/get-process#capability-results-authenticationinfo)를 참조하세요.
Frictionless flow는 이 형식에서 지원되지 않습니다 — [지원되지 않는 신호](#unsupported-signals)를 참조하세요.
### 예제​

```
curl -X POST https://api.idcloud.uat.unico.app/client/v1/process \  -H "Authorization: Bearer $TOKEN" \  -H "Content-Type: application/json" \  -d '{    "expected_result": {      "authentication_info": {        "authentication_result": "AUTHENTICATION_RESULT_POSITIVE",        "liveness_result": "LIVENESS_RESULT_LIVE",        "id_age_result": "ID_AGE_RESULT_POSITIVE"      }    }    // ... 나머지 매개변수는 실제 프로세스 생성 호출에서 사용하는 것과 동일합니다  }'
```

### 응답 (200 OK)​

```
{  "process": {    "id": "53060f52-f146-4c12-a234-5bb5031f6f5b",    "state": "PROCESS_STATE_FINISHED",    "result": "PROCESS_RESULT_OK",    "flow": "your-sandbox-flow",    "simulated": true,    "capacities": ["PROCESS_CAPACITY_IDUNICO", "PROCESS_CAPACITY_IDAGE"],    "authenticationInfo": {      "authenticationResult": "AUTHENTICATION_RESULT_POSITIVE",      "livenessResult": "LIVENESS_RESULT_LIVE",      "idAgeResult": "ID_AGE_RESULT_POSITIVE"    },    "person": { "duiType": "DUI_TYPE_BR_CPF", "duiValue": "12345678909" }  }}
```

### 지원되지 않는 신호​

아래 신호는 모의(mock)에서 두 형식 모두 지원되지 않습니다:

`multi_accounts`
`data_mismatch`
`serial_fraudster`
`smart_revalidation_result`
`passkey_result` (지원 중단됨)

Frictionless flow(생체 인식 캡처 없는 인증)는 `id_cloud_one_result` 형식에서만 지원됩니다 — `authentication_info`에서는 작동하지 않습니다.
### 응답에 대한 참고 사항​

**점수는 신원 결과가 결론에 이르지 못한 경우에만 반환됩니다.** `score_engine_result` 필드는 `authentication_result`가 `AUTHENTICATION_RESULT_INCONCLUSIVE`일 때만 값을 반영합니다. `authentication_result`를 `POSITIVE` 또는 `NEGATIVE`로 모의(mock)하면서 0이 아닌 `score_engine_result`를 함께 전송하면, 전송한 값과 관계없이 최종 응답은 `score_enabled: SCORE_ENABLED_FALSE`와 `score: 0`을 반환합니다.
이는 API의 정상적인 동작입니다 — 동일한 규칙이 실제 프로세스에도 적용되며, 모의(mock)에만 국한된 것이 아닙니다. 테스트하려는 시나리오가 응답에 점수가 표시되는 것에 의존한다면, `authentication_result: AUTHENTICATION_RESULT_INCONCLUSIVE`를 사용하세요.
### 오류​

상황오류샌드박스 외부에서 전송된 `expected_result``PERMISSION_DENIED``id_cloud_one_result`와 `authentication_info`를 함께 전송`INVALID_ARGUMENT`빈 `authentication_info: {}``INVALID_ARGUMENT``authentication_info`에 flow가 반환하는 신호가 누락됨유효성 검사 오류 — 모든 신호를 포함하세요flow가 인식하지 못하는 `id_cloud_one_result` 값유효성 검사 오류`flow`가 모의(mock)를 지원하지 않음유효성 검사 오류
### 다음 단계​

모의 프로세스를 생성한 후, 생체 인식 캡처를 정상적으로 완료하고 [프로세스 조회](/ko/developers/api-reference/get-process)를 사용하여 모의된 결과를 가져오세요.마지막 업데이트 2026년 10월 8일**에