IdFace

IdFace는 셀피에서 고유 식별자를 생성합니다. 사용자는 어떠한 방식으로도 식별자를 입력하거나 선언하지 않습니다 — 신원은 입력값이 아닌 호출의 출력값입니다. 일치에 성공하면 응답은 프로세스 전반에서 사용자를 고유하게 식별하는 안정적이고 불투명한 person_id를 반환합니다.

기능 설명

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

입력값

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

품질 캡처를 위해 SDK 필요

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

가능한 응답

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

응답 예시

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

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

사용 가능 여부

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

이 기능을 사용하는 사용 사례

• Face Identification