--- title: 개요 description: IDCloud API 레퍼런스 — 두 가지 공개 계약(Web & SDK 및 API). canonical: https://developer.unico.io/ko/dual-api/developers/api-reference/ locale: ko generated_by: markdown-export --- - [/ko/](/ko/) - API 레퍼런스 **이 페이지에서# 개요 ### 계약 선택​ 계약 선택은 **생체 캡처가 발생하는 위치**의 결과이지 독립적인 결정이 아닙니다. 아래 표를 참조하세요. 계약사용 시기캡처플로우**[Web & SDK](/ko/dual-api/developers/api-reference/web-sdk)**캡처 여정이 Unico(Web iFrame, Redirect 또는 네이티브 SDK)에 의해 호스팅될 때Unico가 제어프로세스가 캡처 **전**에 생성됨 → 사용자가 여정을 진행 → 콜백 또는 폴링으로 결과 반환**[API](/ko/dual-api/developers/api-reference/api)**애플리케이션이 캡처를 제어하고(Unico SDK 유무에 관계없이) 이미지를 직접 호출에 전송할 때클라이언트가 제어이미지가 프로세스 생성과 **함께** 전송됨 → 결과가 동기적으로 반환됨 ### 호스트 및 환경​ 계약샌드박스 호스트프로덕션 호스트Web & SDK`https://api.idcloud.uat.unico.app``https://api.idcloud.unico.app`API`https://api.id.uat.unico.app``https://api.id.unico.app`OAuth2 / Token`https://identityhomolog.acesso.io``https://identity.acesso.io` 전체 세부 정보는 [환경](/ko/dual-api/developers/api-reference/environments)을 참조하세요. ### 인증​ 모든 Unico 계약은 `urn:ietf:params:oauth:grant-type:jwt-bearer`를 통한 OAuth2로 획득한 **Bearer 토큰(JWT)**을 사용합니다. 전체 세부 정보는 [인증](/ko/dual-api/developers/api-reference/authentication)을 참조하세요. ### 계약 간 페이로드 차이​ 동일한 개념적 작업("신원 확인 프로세스 생성")은 각 계약에서 다르게 보입니다. 통합 간 마이그레이션 시 아래 표를 빠른 참조로 사용하세요. Process creation 항목Web & SDKAPI**엔드포인트**`POST /client/v1/process``POST /processes/v1`**인증**`Authorization: Bearer ``Authorization: Bearer ` + `APIKEY`**이미지**전송 안 함(Unico 여정에서 캡처)`imageBase64`로 전송**사용자 식별**`person.duiType` + `person.duiValue``subject.code` (CPF / CURP)**문서 유형**CPF, CURP, SSN, NIN, DNI, NIKCPF, CURP만**파이프라인 정의**`flow` (열거형, 30+ 값)`APIKEY`에 암시적(기능)**콜백**`callbackUri` (사용자 리디렉션)없음(동기식)**웹훅**Webhook v1 (최종 결과)Webhook v1 (선택 사항)**여정 URL 반환**예 (`userRedirectUrl`)아니오**결과**비동기(GET 폴링 또는 웹훅)동기식(응답에 포함)**SDK 토큰**예 (`token`, `webAppToken`)아니오 Result retrieval 항목Web & SDKAPI**엔드포인트**`GET /client/v1/process/\{id\}``GET /processes/v1/\{id\}` (생성 응답에도 포함)**상태**`state` + `result` (접두사가 붙은 열거형)`status` (1, 3, 5)**결과 구조**`process.authenticationInfo.{capability}Result` 아래에 중첩. 멕시코에서는 `authenticationInfo` 아래에 `idGov`.평탄: `unicoId`, `liveness`, `government`, `identityFraudsters`, `idGov`(멕시코 전용)**문서**`services[].documents[]` (OCR이 있는 RG/CNH)별도 엔드포인트(`GET /processes/v1/\{id\}/document`) ### 다음 단계​ [인증](/ko/dual-api/developers/api-reference/authentication) — OAuth2 흐름 및 JWT 생성 [환경](/ko/dual-api/developers/api-reference/environments) — 샌드박스 대 프로덕션 [Postman 컬렉션](/ko/dual-api/developers/api-reference/postman) — 바로 사용 가능한 컬렉션 [웹훅 및 이벤트](/ko/developers/webhooks-and-events) — 비동기 결과 전달 [SDK 및 도구](/ko/developers/sdks-and-tools/overview) — Web SDK, Android, iOS, Flutter 마지막 업데이트 2026년 10월 8일**에