顔を認証する

顔を認証する

IDによる登録者との1対1の認証。

menu_bookAPI リファレンス: 顔の検証 (1:1)expand_more

公式ドキュメント (英語): docs.verifik.co/biometrics/verify-face. スペイン語: docs.verifik.co/verifik-es/verificar-cara.

Base URL https://api.verifik.co. Send the enrolled person's MongoDB id in id and one or more raw base64 face images in images (no data URL prefix). Optional collection_id scopes the check.

POST /v2/face-recognition/verify

既知の登録者と 1 対 1 で対戦: しきい値に達すると、スコアとの data.match を返します。

ヘッダ価値
Content-Typeapplication/json
AuthorizationBearer <token>
パラメータ要求説明
idはい登録者 MongoDB ID
imagesはいBase64 顔画像の配列 (同じ被写体)
min_scoreはい一致しきい値 (0.5 ~ 1)
search_modeはい速いか正確か
collection_idいいえオプションの収集範囲
await verifyFace(
  {
    id: "<personMongoId>",
    images: ["<base64>", "<base64>"],
    min_score: 0.75,
    search_mode: "FAST",
    collection_id: "<optionalCollectionMongoId>",
  },
  accessToken,
);
  • このデモでは、セッション トークンを使用して @humanauthn/api-client から verifyFace を使用します。
  • 有効になっている場合、応答には data.match と署名ブロックが含まれます。
menu_book

docs.verifik.co の公式ガイド