메인 콘텐츠로 건너뛰기
Face Identifier

Face Identifier는 정부 발급 문서와의 연계가 없는 시나리오를 위해 설계되었습니다 — 개인 정보 보호를 위해 문서 번호 공유를 원하지 않는 고객 상황에서 활용됩니다. 핵심 기능은 단 한 장의 셀피 제출로 각 얼굴에 대한 고유한 신원을 생성하는 것입니다.

이를 통해 다음을 수행할 수 있습니다:

  • 반복 사용자 감지 및 중복 계정 방지 — 공식 문서 없이도 동일 인물의 재방문 또는 여러 계정 생성 시도 여부를 파악하여 일관된 신원 인식을 보장합니다.
  • 웹, 네이티브 또는 API를 통한 통합 — 추가 문서 데이터 없이 셀피 이미지만을 입력값으로 사용합니다.
  • 다른 신호와 결합 — 필요에 따라 다른 기능과 함께 Face Identifier를 추가합니다.

기능 설명​

캡처된 셀피에서 Face Identifier는 해당 얼굴을 고유하게 나타내는 안정적이고 불투명한 생체 식별자(personId)를 생성합니다. 사용자는 어떠한 식별자도 선언하지 않습니다 — 신원은 입력값이 아닌 호출의 출력값입니다. 모든 성공적인 일치에서 응답은 동일한 personId를 반환하므로, 동일한 사용자를 이후 프로세스에서도 인식할 수 있습니다.

입력값​

셀피는 SDK 또는 웹 여정에서 캡처됩니다. 헤드리스 API 통합의 경우, flow=idface를 사용하여 POST /v1/process 요청 본문에 imagebase64로 이미지를 전송합니다. subject.code는 포함하지 마세요 — Face Identifier가 응답에서 personId를 반환합니다.

품질 캡처를 위해 SDK 필요

API를 통해 전송된 이미지가 생체 인식 요건을 충족하도록 하려면, 해당 플랫폼의 Unico SDK를 사용하거나 캡처 표준을 따르세요. Face Identifier는 캡처 품질 관리 없이 임의의 이미지를 허용하지 않습니다.

가능한 응답​

idFace.result의미
FOUND신원 확인 완료. personId가 반환되어 채워집니다.
NOT_FOUND신원 미확인. personId가 없습니다.

응답 예시​

{
  "id": "1c1fc38b-7e98-4f9a-a04d-7a4a8b29d2c1",
  "status": 3,
  "idFace": {
    "personId": "a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890",
    "result": "FOUND"
  }
}

personId는 안정적인 불투명 식별자입니다 — 동일한 사용자는 항상 동일한 값으로 확인됩니다. 이후 Face Identifier 호출에서 동일한 사람을 인식하기 위해 사용자 레코드와 함께 저장하세요.

사용 가능 여부​

인터페이스지원 여부
SDK (Android, iOS, Flutter)✅
Web (iFrame, Redirect)✅
API (헤드리스, SDK 없음)✅
마지막 업데이트 에