顔を認証する
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-Type | application/json |
| Authorization | Bearer <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 の公式ガイド