생명력이 있는 사람 만들기
한 번의 호출로 등록 + 활성 확인 + 중복 제거 검색을 수행할 수 있습니다.
menu_bookAPI 참조: 활동성이 있는 사람 만들기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
제출된 얼굴에 대해 활성 상태를 실행하고 유사한 등록을 검색한 다음 대상 컬렉션에서 사람을 생성하거나 업데이트합니다.
| 헤더 | 값 |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
| 매개변수 | 요청 | 설명 |
|---|---|---|
| 이름 | 예 | 표시 이름 |
| 이미지 | 예 | base64 얼굴 이미지 배열(데이터 URL이 아닌 원시 base64) |
| 성별 | 예 | M 또는 F |
| 생일 | 예 | YYYY-MM-DD |
| collection_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 공식 가이드