生き生きとした人物を創る
1 回の呼び出しで登録 + 活性チェック + 重複排除検索を実行します。
menu_bookAPI リファレンス: Liveness を持つ人物の作成expand_more
公式ドキュメント (英語): docs.verifik.co/resources/create-a-person-with-liveness
ドキュメント (スペイン語): docs.verifik.co/verifik-es/resources/personas/crear-una-persona-con-deteccion-de-vida
Base URL https://api.verifik.co. Send JSON with profile fields, a single collection_id (collection _id), liveness and search thresholds, and at least one base64 face image per entry in images (no data URL prefix).
POST /v2/face-recognition/persons/search-live-face
送信された顔に対して liveness を実行し、同様の登録を検索して、ターゲット コレクション内の人物を作成または更新します。
| ヘッダ | 価値 |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
| パラメータ | 要求 | 説明 |
|---|---|---|
| 名前 | はい | 表示名 |
| 画像 | はい | Base64 顔画像の配列 (データ URL ではなく生の Base64) |
| 性別 | はい | MまたはF |
| 生年月日 | はい | YYYY-MM-DD |
| コレクションID | はい | 単一のコレクションの一意の ID |
| liveness_min_score | はい | 0.5~1 |
| min_score | はい | 内部検索しきい値、0.5 ~ 1 |
| 検索モード | はい | 速いか正確か |
| 国籍 | いいえ | オプション |
await fetch("https://api.verifik.co/v2/face-recognition/persons/search-live-face", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: `Bearer ${accessToken}`,
},
body: JSON.stringify({
name: "Jane Doe",
gender: "F",
date_of_birth: "1990-01-15",
collection_id: "<collectionMongoId>",
liveness_min_score: 0.65,
min_score: 0.8,
search_mode: "FAST",
nationality: "CO",
images: ["<base64>", "<base64>"],
}),
});- このデモでは、セッション トークンを使用して @humanauthn/api-client から createpersonWithLiveness を使用します。
- 環境に応じて、応答にはデータと一緒に署名ブロックが含まれる場合があります。
menu_book
関連ドキュメント
docs.verifik.co の公式ガイド