一、接口概述

人脸身份证比对接口旨在通过先进的图像识别与数据匹配技术，准确验证用户提供的人脸图像与身份证信息中的人脸是否为同一人。该接口支持多种格式的图像输入，适用于各类需要进行身份核验的应用场景，如金融开户、门禁系统、线上认证等，为保障业务安全、合规开展提供有力支持。

二、对接步骤

1.选购合适的接口服务商

在接入人脸身份证比对接口之前，首先需要选择一个合适的接口提供商，比如数脉API。通常需要考虑以下几个因素：

准确性：确保接口算法能够准确识别核验人脸信息，同时比对的身份证数据需来源官方渠道，以保证核验数据的安全性，一般需要接口核验准确率99%以上。

速度：对于查询方来说，快速响应是非常重要的。人脸身份证比对接口应该要保证在短时间内返回识别结果，避免用户因长时间等待而感到不耐烦。尤其是在高并发情况下的平均响应时间。

易用性：接口需要保证容易的集成和使用，提供详细的API文档和示例，以帮助对接人员评估易用性。

隐私与安全：人脸数据对于用户来说，是高隐私度的个人数据，所以需要保证选用的人脸身份证比对接口的安全性，以充分保护数据安全和用户隐私。

其他支持：API接口对接中可能需要接口方提供一定技术支持。

2.账号申请

访问接口服务费方的官方网站（数脉API），进行注册。

按照系统提示填写企业实名认证，获取接口密钥。

3.接口调用

使用选定的编程语言构建 HTTP 请求。以 Python为例：

#!/usr/bin/python

# -*- coding: utf-8 -*-

import requests

import time

import hashlib

url = "https://api.shumaidata.com/v4/face_id_card/compare"

appid = "数脉分配给你的appid"

appsecurity = "数脉分配给你的appsecurity"

timestamp = int(time.time() * 1000)

newSign = "{}&{}&{}".format(appid,timestamp,appsecurity)

sign = hashlib.md5(newSign.encode("utf8")).hexdigest()

name = "姓名";

idcard = "身份证号码";

image = "人脸照片base64字符串"

params = {"image":image,"name":name,"idcard":idcard,"appid":appid,"timestamp":timestamp,"sign":sign}

headers = {'Content-Type': "application/x-www-form-urlencoded"}

response = requests.post(url, data = params, headers = headers)

print (response.text)

4.正确返回

{

    "msg": "成功",

    "success": true,

    "code": 200,

    "data": {

        "order_no": "673106944390729728",

        "score": 0.86,

        "msg": "系统判断为同一人",

        "incorrect": 100,

        "sex": "男",

        "birthday": "19930123",

        "address": "江西省吉安地区遂川县"

    }

}

5.错误返回

{

    "msg": "入参错误，身份证号[idcard]格式错误",

    "success": false,

    "code": 400,

    "data": {}

}