IdFace

IdFace はセルフィーから一意の識別子を生成します。ユーザーは識別子を入力したり他の方法で申告したりする必要はありません — 本人確認は呼び出しの出力であり入力ではありません。照合に成功した場合、レスポンスにはプロセス全体でユーザーを一意に識別する安定した不透明な person_id が返されます。

機能概要

キャプチャされたセルフィーから、IdFace はその顔を一意に表す安定した不透明な生体認証識別子（person_id）を生成します。ユーザーは識別子を申告する必要はありません — 本人確認は呼び出しの出力であり入力ではありません。照合が成功するたびに同じ person_id が返されるため、将来のプロセスで同じユーザーを認識することができます。

入力

セルフィーは SDK または Web ジャーニーによってキャプチャされます。ヘッドレス 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、リダイレクト）	✅
API（ヘッドレス、SDK なし）	✅

このケイパビリティを使用するユースケース

• Face Identification