얼굴 인증
ID를 통해 가입한 본인을 1:1로 인증합니다.
menu_bookAPI 참조: 얼굴 확인(1:1)expand_more
공식 문서(EN): 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 공식 가이드