얼굴 인증

얼굴 인증

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-Typeapplication/json
AuthorizationBearer <token>
매개변수요청설명
id등록된 사람 MongoDB ID
imagesBase64 얼굴 이미지 배열(동일한 피사체)
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 공식 가이드