メインコンテンツへスキップ
Face Identifier

Face Identifier は、政府発行書類との関係がないシナリオ — プライバシー上の理由から書類番号の共有を避けたい顧客の状況 — 向けに設計されています。その核心的な機能は、1回のセルフィー送信から各顔に固有のアイデンティティを作成することです。

これにより、次のことが可能になります：

  • リピートユーザーの検出と重複アカウントの防止 — 同一人物が再訪しているか複数のアカウントを作成しようとしているかを認識し、公式書類なしで一貫したアイデンティティ認識を確保します。
  • Web、ネイティブ、または API 経由での統合 — セルフィー画像のみを入力として使用し、追加の書類データは不要です。
  • 他のシグナルとの組み合わせ — 必要に応じて Face Identifier を他のケイパビリティと組み合わせて追加できます。

機能概要​

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

入力​

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