ID卡人像照片验证API集成指南

用户00045392116
4 阅读4分钟

在数字化时代，身份验证变得尤为重要。Ace Data Cloud 提供的 ID 卡人像照片验证 API 可以帮助开发者快速集成身份证信息验证功能。该 API 允许用户输入身份证照片，识别照片上的信息，并与权威数据库进行对比，从而验证身份证信息的真实性。

背景介绍

Ace Data Cloud 是一个集成多种数据处理服务的平台，提供包括身份验证、数据分析等多种功能。特别是在金融、安防等行业中，对身份的验证需求日益增加，使用 ID 卡人像照片验证 API 可以有效地提升用户身份确认的效率和准确性。

应用流程

要使用该 API，首先需要在 ID卡人像照片验证API 页面申请服务。进入页面后，点击“获取”按钮，如下图所示：

如果您尚未登录或注册，系统会自动跳转到登录页面，邀请您进行注册和登录。登录或注册后，您将自动返回当前页面。

首次申请时，系统将提供免费的配额，允许您免费使用该 API。

基本使用方法

在使用 API 之前，了解基本的使用方法至关重要。只需输入 ID 卡图像的链接，即可获取处理后的验证结果。您需要传递 image_url 字段，系统将生成相应的内容，如下图所示：

在请求头中，我们需要设置以下内容：

  • accept：您希望接收的响应结果格式，这里填为 application/json，表示以 JSON 格式返回。
  • authorization：调用 API 的密钥，可以在申请后直接选择。

请求体的设置包括：

  • image_url：需要处理的身份证图像的链接。
  • config：可选配置项，布尔字段，默认为 false，支持 copy_warn、border_check_warn、reshoot_warn、detect_ps_warn、temp_id_warn、quality（阈值 0-100）。

选择后，您可以在右侧看到生成的代码，如下图所示：

点击“试试”按钮进行测试，您将获得如下结果：

{
  "sim": 99.76,
  "result": "Success",
  "description": "成功",
  "name": "身份证姓名",
  "sex": "身份证性别",
  "nation": "身份证民族",
  "birth": "身份证生日",
  "address": "身份证家庭住址",
  "id_num": "身份证号码",
  "portrait": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBA.....DEhE2lbPMcOtG3f/DLT/yX8if7Kxn/AD7h85wdttPifRf1e6//2Q==",
  "warnings": "",
  "quality": 0,
  "encryption": null
}

返回结果包含多个字段，具体说明如下：

  • sim：相似度，值范围为 [0.00, 100.00]。建议相似度 70 以上可判断为同一人，具体阈值可根据场景调整。
  • result：业务错误代码，成功时返回“Success”；错误时请参考错误代码列表。
  • description：姓名和身份证号验证结果。
  • name、sex、nation、birth、address、id_num：身份证上相应的信息，未上传身份证图像时为空。
  • portrait：身份证人像照片的 base64 编码。
  • warnings：警告信息，配置警告时，比较将停止。
  • quality：图像质量分数，仅在配置了模糊警告时有意义。
  • encryption：敏感数据加密信息。

通过这些信息，可以高效地验证身份证的真实性。

如果您希望生成相应的集成代码，可以直接复制，以下是 CURL 代码示例：

curl -X POST 'https://api.acedata.cloud/identity/idcard/check-1e' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "image_url": {image_url}
}'

Python 集成代码示例：

import requests

url = "https://api.acedata.cloud/identity/idcard/check-1e"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "image_url": {image_url}
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

错误处理

在调用 API 时，如果发生错误，API 将返回相应的错误代码和信息。例如：

  • 400 token_mismatched：坏请求，可能缺少或无效参数。
  • 401 invalid_token：未授权，授权令牌无效或缺失。
  • 429 too_many_requests：请求过多，超过了速率限制。
  • 500 api_error：内部服务器错误，服务器出现问题。

错误响应示例

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

总结

通过本文，您已了解如何使用 ID 卡人像照片验证 API，输入身份证照片，识别信息，并与权威数据库进行对比，从而验证身份证信息的真实性。这将帮助您更好地集成和使用该 API。如有疑问，请随时联系技术支持团队。

了解更多关于 Ace Data Cloud 的信息。

标签：#身份验证 #API集成 #数据处理 #AceDataCloud #图像识别

avatar
文章
阅读
粉丝