メインコンテンツへスキップ
Human Token

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

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

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

機能概要​

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

入力​

セルフィーは SDK または Web Journey によってキャプチャされます。ヘッドレス API 統合の場合、画像は POST /processes/v1 のリクエストボディに imagebase64 として送信します。subject.code は含めないでください — Human Token はレスポンスに personId を返します。

品質キャプチャには SDK が必要です

API 経由で送信される画像が生体認証要件を満たすことを保証するには、お使いのプラットフォーム向けの Unico SDK を使用するか、キャプチャ標準に従ってください。Human Token はキャプチャ品質管理なしの任意の画像は受け付けません。

想定されるレスポンス​

idFace.result意味
FOUND本人確認済み。personId に値が入っています。
personId を生成できない場合

Human Token が personId を生成できないシナリオは一つだけです。送信された画像から顔を識別できない場合です — 顔が検出されない、画像品質が低すぎる、またはキャプチャ標準の範囲外である顔（傾いている、横を向いている）である場合です。これは result の値ではありません — リクエストは 20532 — No face detected in image で失敗します。キャプチャ標準に従うことがこれを防ぎます。

レスポンス例​

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

personId は安定した不透明な識別子です — 同じユーザーは常に同じ値に解決されます。後続の Human Token 呼び出しで同一人物を認識するために、ユーザーレコードと並べて保存してください。

利用可能な環境​

サーフェスサポート
SDK（Android、iOS、Flutter）✅
Web（iFrame、リダイレクト）✅
API（ヘッドレス、SDK なし）✅
最終更新 に