--- title: 프로세스 조회 description: 식별자로 기존 API 계약 프로세스를 조회합니다. 결과는 생성 시 동기적으로 반환되므로 재조회에 사용됩니다. canonical: https://developer.unico.io/ko/dual-api/developers/api-reference/api/get-process locale: ko generated_by: markdown-export --- - [/ko/](/ko/) - [API 레퍼런스](/ko/dual-api/developers/api-reference/) - [API](/ko/dual-api/developers/api-reference/api/) - 프로세스 조회 **이 페이지에서프로세스 조회GET식별자로 기존 프로세스를 조회합니다. API 계약에 따라 결과는 프로세스 생성 시 이미 동기적으로 반환됩니다 — 이 엔드포인트는 재조회, 감사, 지원 목적으로 사용하세요. 경고프로세스를 조회하기 전에 웹훅 설정 및 폴백 전략을 검토하세요 — [여기를 클릭하세요](/ko/developers/webhooks-and-events/setup). ### 엔드포인트​ 환경URL**프로덕션**`GET https://api.id.unico.app/processes/v1/{processId}`**샌드박스**`GET https://api.id.uat.unico.app/processes/v1/{processId}` ### 요청​ 헤더 헤더값`Authorization``Bearer ``APIKEY`프로비저닝된 API 키. 경로 파라미터 파라미터유형필수설명`processId`string (UUID)예[프로세스 생성](/ko/dual-api/developers/api-reference/api/post-processes)에서 반환된 프로세스 식별자. ### 예제​ cURLNode.js``` curl -X GET https://api.id.unico.app/processes/v1/$PROCESS_ID \ -H "Authorization: Bearer $TOKEN" \ -H "APIKEY: $API_KEY" ``` ``` import fetch from 'node-fetch';const res = await fetch( `https://api.id.unico.app/processes/v1/${processId}`, { headers: { Authorization: `Bearer ${accessToken}`, APIKEY: apiKey } });const result = await res.json(); ``` ### 응답​ 200 OK 이 계약은 단일합니다 — `idCloud.result` 필드가 사용된 기능들의 통합 판정을 전달합니다. Unico는 실행된 기능들의 결과를 단일 `idCloud.result`로 통합하여, 개별 결과를 조정할 필요 없이 플로우의 다음 단계를 바로 결정할 수 있게 합니다. ``` { "id": "80371b2a-3ac7-432e-866d-57fe37896ac6", "status": 3, "idCloud": { "result": "approved" }} ``` 필드유형설명`id`string (UUID)프로세스 식별자.`status`integer`1` (처리 중), `2` (불일치), `3` (성공적으로 완료), `4` (취소됨), `5` (오류). 가능한 결과 값 idCloud.result의미권장 조치approved실제 사람이며 신원이 검증되었습니다.플로우를 진행하세요.denied신원이 검증되지 않았거나, 라이브니스 검사에 실패했거나, 극단적인 위험이 감지되었습니다.플로우를 종료하거나 대체 플로우로 리디렉션하세요.critical-risk심각한 위험 수준이 감지되었습니다.플로우를 종료하거나 수동 검토로 라우팅하세요.high-risk높은 위험 수준이 감지되었습니다.수동 검토 또는 대체 플로우로 라우팅하세요.retry평가하기에 캡처 또는 점수가 불충분합니다.사용자에게 새로운 캡처를 요청하세요.inconclusive판정을 내리기에 증거가 충분하지 않습니다.수동 검토 또는 대체 플로우로 라우팅하세요. 반환되는 값은 APIKey에 구성된 레시피에 따라 다릅니다. 각 레시피가 반환할 수 있는 결과 값은 [플로우](/ko/dual-api/developers/api-reference/api/flows)를 참조하세요. 브라질의 클라이언트는 기능별 응답을 받을 수 있습니다전체 응답 구조는 동일하게 유지됩니다 — 단일 결과가 기본값입니다.브라질의 통합은 개방형의 기능별 결과를 받을 수 있습니다. APIKey에서 활성화된 각 기능은 응답에 자체 블록을 추가하며, 비활성화된 기능의 필드는 생략됩니다.``` { "id": "80371b2a-3ac7-432e-866d-57fe37896ac6", "status": 3, "unicoId": { "result": "yes" }, "riskLevel": { "result": "inconclusive" }, "idFace": { "personId": "a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890", "result": "FOUND" }, "identityFraudsters": { "result": "inconclusive" }, "government": { "serpro": 87 }, "liveness": 1, "idAge": { "result": "yes" }, "cardholderVerification": { "result": "approved" }} ``` 필드유형설명`unicoId.result`string`yes`, `no`, `inconclusive` — [신원 확인](/ko/capabilities/identity-verification) 참조.`riskLevel.result`string`not_approved`, `critical_risk`, `high_risk`, `inconclusive` — [사기 위험 분류](/ko/capabilities/fraud-risk-classification) 참조.`idFace.result`string`FOUND` — 얼굴 식별자 참조.`idFace.personId`string얼굴에 대한 안정적인 불투명 식별자로, `idFace.result = FOUND`와 함께 반환됩니다. 이미지에서 얼굴을 식별할 수 없는 경우, 프로세스는 `idFace` 블록 대신 오류 `20532`를 반환합니다.`identityFraudsters.result`string**더 이상 사용되지 않습니다.** 대신 `riskLevel`을 사용하세요. 통합이 진행 중인 클라이언트는 프로젝트 팀과 마이그레이션을 조율하면서 계속 사용할 수 있습니다.`government.serpro`integerSerpro 유사도 점수 (0–100, -1, -2). 브라질에서만 사용 가능합니다. [Serpro 유사도 반환](/ko/capabilities/serpro-similarity-return) 참조.`liveness`integer`1` (통과), `2` (실패) — [라이브니스](/ko/capabilities/liveness) 참조.`idAge.result`string`yes`, `no`, `inconclusive` — [연령 인증](/ko/capabilities/age-verification) 참조. 브라질에서만 사용 가능합니다.`score`integer확률적 위험 점수. `unicoId.result = inconclusive`이고 위험 점수 오케스트레이션이 활성화된 경우 존재합니다. 양수 값은 본인일 확률이 높음을, 음수 값은 위험이 높음을 나타냅니다. 브라질에서만 사용 가능합니다.`cardholderVerification.result`string`approved`, `unsure` — [Cardholder Verification](/ko/capabilities/cardholder-verification) 참조. `status`가 아직 `3` (완료)이 아닌 동안에는 존재하지 않습니다. 브라질에서만 사용 가능합니다. 멕시코의 클라이언트는 RENAPO Verification 블록을 받을 수 있습니다응답 구조는 동일하게 유지되며 idGov 블록이 추가됩니다.RENAPO Verification이 활성화된 멕시코의 통합은 사용자의 CURP에 대해 RENAPO가 보유한 기록이 담긴 추가 idGov 블록을 받습니다. 이는 신원 결과와는 별개의 응답입니다.``` { "id": "11111111-2222-3333-4444-555555555555", "status": 3, "idCloud": { "result": "approved" }, "idGov": { "government_valid": true, "curp": "PUEA880304MDFRJN04", "government_name": "ANA PRUEBA EJEMPLO", "date_of_birth": "1988-03-04", "age": 38, "gender": "F", "deceased": false, "is_mexican": true, "citizenship": "MEXICO", "state_of_birth": "Ciudad de México", "state_iso": "MX-CMX", "issuing_entity_code": "DF", "municipality_registration": "" }} ``` 필드유형설명`idGov`objectCURP에 대한 RENAPO 기록. 기능이 활성화되지 않은 경우 없음. RENAPO가 응답하지 않은 경우 `{}`. 멕시코 전용. [RENAPO Verification](/ko/capabilities/renapo-verification) 참조. ### 이 엔드포인트를 사용하는 경우​ API 계약은 결과를 동기적으로 반환하므로 대부분의 통합에서는 이 엔드포인트가 필요하지 않습니다. 다음과 같은 경우에 사용하세요: `processId`만 저장하고 나중에 전체 결과를 조회해야 하는 경우 (감사, 지원). 원래 응답이 전송 중 손실된 것으로 의심되는 경우 (플랫폼이 작업을 완료한 후 네트워크 오류 발생). 이전 프로세스를 검토하는 백오피스 도구를 구축하는 경우. ### 오류 코드​ 400 Bad Request404 Not Found403 Forbidden410 Gone429 Too Many Requests500 Internal Server Error코드메시지설명`20023`O parâmetro processId não foi informado.processId 파라미터가 누락되었습니다.`20002`O parâmetro APIKey não foi informado.요청 헤더에 APIKEY 파라미터가 누락되었습니다.`20001`O parâmetro authtoken não foi informado.요청 헤더에 통합 토큰 파라미터가 누락되었습니다.코드메시지설명`50001`O processo informado não foi encontrado.해당 프로세스가 데이터베이스에 존재하지 않습니다.코드메시지설명`30017`User does not have permission to perform this action.잘못된 형식의 JWT이거나 이 작업을 수행할 권한이 없는 사용자입니다.`10502`O token informado está expirado.사용된 액세스 토큰이 만료되었습니다.`10501`O token informado é inválido.인증 토큰이 유효하지 않습니다.`10201`O AppKey informado é inválido.APIKEY 파라미터가 입력되지 않았거나 존재하지 않습니다.프로세스가 존재하지만 오류가 발생했습니다. `id`와 `status: 5`만 반환됩니다.레이트 리밋에 도달했습니다. 시스템이 HTTP 429 오류를 수신하면 연쇄적인 장애를 방지하고 제한이 악화되지 않도록 메커니즘을 구현해야 합니다. **모범 사례:** **쿨다운 기간(backoff):** 시스템에서 후속 요청을 즉시 중지하거나 줄이세요. 실패한 요청을 촘촘한 루프에서 지속적으로 재시도하지 마세요. **큐잉 및 스로틀링(Queueing & throttling):** 재전송하기 전에 발신 요청을 버퍼링하거나 대기열에 넣어 트래픽 흐름을 제어하세요. **지터를 포함한 지수 백오프(Exponential backoff with jitter):** 재시도 시 시도 간 대기 시간을 기하급수적으로 늘리고(예: 1초, 2초, 4초, 8초) 작은 무작위 지연("지터")을 추가하여 대기열의 모든 요청이 정확히 같은 밀리초에 재시도하는 허드 효과를 방지하세요. 경고백오프 없이 레이트 리밋이 적용된 엔드포인트에 지속적으로 요청을 보내면 **제한 기간이 연장되고** 시스템의 운영 처리량에 심각한 영향을 미칠 수 있습니다. 요청을 적절히 스로틀링하면 더 원활하고 탄력적인 통합이 보장됩니다. 기본 제한, 요청 증가 및 추가 세부 정보는 [레이트 리밋](/ko/dual-api/developers/api-reference/rate-limits)을 참조하세요.코드메시지설명`99999`Internal failure! Try again later내부 오류가 발생했습니다. ### 플로우​ 레시피는 프로젝트의 APIKey에 구성된 기능(라이브니스, 신원 확인, 위험 신호, 문서 등)의 조합입니다. 이는 Unico가 각 프로세스에서 실행하는 작업과 결과가 단일 `result`로 통합되는 방식을 정의합니다 — 사용자 측에서는 아무것도 조정할 필요가 없습니다. Unico는 사전 정의되고 이름과 버전이 지정된 레시피 카탈로그를 관리합니다 (예: `byunico-idlive-idunico-oneresponse-std`). Score, Serpro 또는 연령 인증을 포함하는 레시피와 같이 일부는 브라질 전용입니다. 프로세스가 실행하는 기능은 무엇인가요?기능의 조합 — 즉 프로젝트의 플로우 — 는 APIKey 설정에서 정의됩니다. 사전 정의된 레시피를 확인하거나, 이를 맞춤화하려면 Unico 프로젝트 담당자에게 문의하세요.마지막 업데이트 2026년 10월 8일**에