메인 콘텐츠로 건너뛰기
프로세스 조회GET

식별자로 기존 프로세스를 조회합니다. API 계약에 따라 결과는 프로세스 생성 시 이미 동기적으로 반환됩니다 — 이 엔드포인트는 재조회, 감사, 지원 목적으로 사용하세요.

MarkdownChatGPTClaude
경고

프로세스를 조회하기 전에 웹훅 설정 및 폴백 전략을 검토하세요 — 여기를 클릭하세요.

엔드포인트​

환경URL
프로덕션GET https://api.id.unico.app/processes/v1/{processId}
샌드박스GET https://api.id.uat.unico.app/processes/v1/{processId}

요청​

헤더
헤더값
AuthorizationBearer <access_token>
APIKEY프로비저닝된 API 키.
경로 파라미터
파라미터유형필수설명
processIdstring (UUID)예프로세스 생성에서 반환된 프로세스 식별자.

예제​

curl -X GET https://api.id.unico.app/processes/v1/$PROCESS_ID \
  -H "Authorization: Bearer $TOKEN" \
  -H "APIKEY: $API_KEY"

응답​

200 OK

이 계약은 단일합니다 — idCloud.result 필드가 사용된 기능들의 통합 판정을 전달합니다.

Unico는 실행된 기능들의 결과를 단일 idCloud.result로 통합하여, 개별 결과를 조정할 필요 없이 플로우의 다음 단계를 바로 결정할 수 있게 합니다.

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "idCloud": {
    "result": "approved"
  }
}
필드유형설명
idstring (UUID)프로세스 식별자.
statusinteger1 (처리 중), 2 (불일치), 3 (성공적으로 완료), 4 (취소됨), 5 (오류).
가능한 결과 값
idCloud.result의미권장 조치
approved실제 사람이며 신원이 검증되었습니다.플로우를 진행하세요.
denied신원이 검증되지 않았거나, 라이브니스 검사에 실패했거나, 극단적인 위험이 감지되었습니다.플로우를 종료하거나 대체 플로우로 리디렉션하세요.
critical-risk심각한 위험 수준이 감지되었습니다.플로우를 종료하거나 수동 검토로 라우팅하세요.
high-risk높은 위험 수준이 감지되었습니다.수동 검토 또는 대체 플로우로 라우팅하세요.
retry평가하기에 캡처 또는 점수가 불충분합니다.사용자에게 새로운 캡처를 요청하세요.
inconclusive판정을 내리기에 증거가 충분하지 않습니다.수동 검토 또는 대체 플로우로 라우팅하세요.

반환되는 값은 APIKey에 구성된 레시피에 따라 다릅니다. 각 레시피가 반환할 수 있는 결과 값은 플로우를 참조하세요.

Brazil브라질의 클라이언트는 기능별 응답을 받을 수 있습니다

전체 응답 구조는 동일하게 유지됩니다 — 단일 결과가 기본값입니다.

브라질의 통합은 개방형의 기능별 결과를 받을 수 있습니다. 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.resultstringyes, no, inconclusive — 신원 확인 참조.
riskLevel.resultstringnot_approved, critical_risk, high_risk, inconclusive — 사기 위험 분류 참조.
idFace.resultstringFOUND — 얼굴 식별자 참조.
idFace.personIdstring얼굴에 대한 안정적인 불투명 식별자로, idFace.result = FOUND와 함께 반환됩니다. 이미지에서 얼굴을 식별할 수 없는 경우, 프로세스는 idFace 블록 대신 오류 20532를 반환합니다.
identityFraudsters.resultstring더 이상 사용되지 않습니다. 대신 riskLevel을 사용하세요. 통합이 진행 중인 클라이언트는 프로젝트 팀과 마이그레이션을 조율하면서 계속 사용할 수 있습니다.
government.serprointegerSerpro 유사도 점수 (0–100, -1, -2). 브라질에서만 사용 가능합니다. Serpro 유사도 반환 참조.
livenessinteger1 (통과), 2 (실패) — 라이브니스 참조.
idAge.resultstringyes, no, inconclusive — 연령 인증 참조. 브라질에서만 사용 가능합니다.
scoreinteger확률적 위험 점수. unicoId.result = inconclusive이고 위험 점수 오케스트레이션이 활성화된 경우 존재합니다. 양수 값은 본인일 확률이 높음을, 음수 값은 위험이 높음을 나타냅니다. 브라질에서만 사용 가능합니다.
cardholderVerification.resultstringapproved, unsure — Cardholder Verification 참조. status가 아직 3 (완료)이 아닌 동안에는 존재하지 않습니다. 브라질에서만 사용 가능합니다.
Mexico멕시코의 클라이언트는 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": ""
  }
}
필드유형설명
idGovobjectCURP에 대한 RENAPO 기록. 기능이 활성화되지 않은 경우 없음. RENAPO가 응답하지 않은 경우 {}. 멕시코 전용. RENAPO Verification 참조.

이 엔드포인트를 사용하는 경우​

API 계약은 결과를 동기적으로 반환하므로 대부분의 통합에서는 이 엔드포인트가 필요하지 않습니다. 다음과 같은 경우에 사용하세요:

  • processId만 저장하고 나중에 전체 결과를 조회해야 하는 경우 (감사, 지원).
  • 원래 응답이 전송 중 손실된 것으로 의심되는 경우 (플랫폼이 작업을 완료한 후 네트워크 오류 발생).
  • 이전 프로세스를 검토하는 백오피스 도구를 구축하는 경우.

오류 코드​

코드메시지설명
20023O parâmetro processId não foi informado.processId 파라미터가 누락되었습니다.
20002O parâmetro APIKey não foi informado.요청 헤더에 APIKEY 파라미터가 누락되었습니다.
20001O parâmetro authtoken não foi informado.요청 헤더에 통합 토큰 파라미터가 누락되었습니다.

플로우​

레시피는 프로젝트의 APIKey에 구성된 기능(라이브니스, 신원 확인, 위험 신호, 문서 등)의 조합입니다. 이는 Unico가 각 프로세스에서 실행하는 작업과 결과가 단일 result로 통합되는 방식을 정의합니다 — 사용자 측에서는 아무것도 조정할 필요가 없습니다.

Unico는 사전 정의되고 이름과 버전이 지정된 레시피 카탈로그를 관리합니다 (예: byunico-idlive-idunico-oneresponse-std). Score, Serpro 또는 연령 인증을 포함하는 레시피와 같이 일부는 브라질 전용입니다.

프로세스가 실행하는 기능은 무엇인가요?

기능의 조합 — 즉 프로젝트의 플로우 — 는 APIKey 설정에서 정의됩니다. 사전 정의된 레시피를 확인하거나, 이를 맞춤화하려면 Unico 프로젝트 담당자에게 문의하세요.

마지막 업데이트 에