👥 人脸验证

该 SDK 将人脸验证 API 封装为一次类型化的调用 — 每请求 0.3 IC。传入两张人脸图像（例如，来自主动活体检测会话的自拍照和从捕获的身份证裁剪的人像），即可获得相似度得分和匹配/不匹配的决定。此页面流程中不包含摄像头 UI — 这是一个纯粹的 API 客户端调用。

Flutter

import 'package:iapp_ekyc_sdk/iapp_ekyc_sdk.dart';

final client = IappEkycClient(apiKey: 'YOUR_API_KEY');

final result = await client.verifyFaces(
  file1: selfieBytes,   // e.g. from ActiveLivenessView
  file2: idFaceBytes,   // e.g. from DocumentCaptureView
);

if (result.matched) {
  // 同一个人 — 更多详情请参阅 result.raw 中的得分与阈值
}

Web

import { IappEkyc } from '@iapp-technology/ekyc-sdk';

const ekyc = new IappEkyc({ apiKey: 'YOUR_API_KEY' });

const result = await ekyc.verifyFaces({
  file1: selfieBlob,
  file2: idFaceBlob,
});

if (result.matched) {
  // 同一个人
}

iOS / Android / React Native

原生封装库包含 faceCapture 流程，用于自动捕获清晰的正脸自拍照；从您的应用程序或后端提交返回的 JPEG 到此 API。为了获得防欺骗的端到端流程，请优先使用主动活体检测 — 其服务器签名的结果已包含被动活体检测。设置：iOS, Android & React Native。

注意事项

• 默认匹配阈值目标是99.50% 的精度；提高它以降低误接受率 — 请参阅理解相似度得分。
• 图像仅保留在内存中，并且仅发送到配置的 baseUrl — SDK 绝不会将其写入磁盘。
• 按次计费的调用：SDK 在发送请求正文后绝不自动重试。

了解更多

• 产品 API：人脸验证
• SDK 设置：入门指南
• 来源：github.com/iapp-technology/iapp-ekyc-sdk