首页 > 其他分享 >身份证信息认证服务—— Identity IdCard OCR API

身份证信息认证服务—— Identity IdCard OCR API

时间:2024-08-18 12:26:03浏览次数:13  
标签:身份证 url IdCard 身份证号 信息 API 姓名 OCR

Identity IdCard OCR API 对接说明

本文将介绍一种通过输入身份证图片 或 姓名和身份证号码,来校验姓名和身份证号的真实性和一致性。本接口用于校验姓名和身份证号的真实性和一致性,您可以通过输入姓名和身份证号或传入身份证人像面照片提供所需验证信息。我们的上游是接入了腾讯云的身份证信息服务平台API。

接下来介绍下 Identity IdCard OCR API 的对接说明。

注册链接

点击链接注册,即可使用!

申请流程

要使用 API,需要先到 Identity IdCard OCR API 对应页面申请对应的服务,进入页面之后,点击「Acquire」按钮,如图所示:

如果你尚未登录或注册,会自动跳转到登录页面邀请您来注册和登录,登录注册之后会自动返回当前页面。

在首次申请时会有免费额度赠送,可以免费使用该 API。

基本使用

首先先了解下基本的使用方式,就是输入身份证图片链接,便可获得处理后验证结果,首先需要简单地传递一个 image_url 字段,我们接下来就可以在界面上填写对应的内容,如图所示:

可以看到这里我们设置了 Request Headers,包括:

  • accept:想要接收怎样格式的响应结果,这里填写为 application/json,即 JSON 格式。
  • authorization:调用 API 的密钥,申请之后可以直接下拉选择。

另外设置了 Request Body,包括:

  • image_url:需要处理的人脸图片链接。
  • age_infos:关于人脸年龄和区域信息,其中年龄是必选参数。

选择之后,可以发现右侧也生成了对应代码,如图所示:

点击「Try」按钮即可进行测试,如上图所示,这里我们就得到了如下结果:

{
  "result": "0",
  "description": "姓名和身份证号一致",
  "name": "身份证姓名",
  "id_card": "身份证号码",
  "sex": "身份证性别",
  "nation": "身份证民族",
  "birth": "身份证生日",
  "address": "身份证家庭住址"
}

返回结果一共有多个字段,介绍如下:

  • result ,认证结果码,收费情况如下。
    • 收费结果码:
      • 0: 姓名和身份证号一致
      • -1: 姓名和身份证号不一致
    • 不收费结果码:
      • -2: 非法身份证号(长度、校验位等不正确)
      • -3: 非法姓名(长度、格式等不正确)
      • -4: 证件库服务异常
      • -5: 证件库中无此身份证记录
      • -6: 权威比对系统升级中,请稍后再试
      • -7: 认证次数超过当日限制。
  • description,此处姓名与身份证号码验证的结果。
  • name,身份证中的姓名信息,如果没有上传身份证图片则是空的。
  • id_card,身份证中的身份证号码信息,如果没有上传身份证图片则是空的。
  • sex,身份证中的性别信息,如果没有上传身份证图片则是空的。
  • nation,身份证中的民族信息,如果没有上传身份证图片则是空的。
  • birth,身份证中的生日信息,如果没有上传身份证图片则是空的。
  • address,身份证中的家庭住址信息,如果没有上传身份证图片则是空的。

可以看出身份证中姓名与身份证号码的信息是一致性并且有效的,同时也使用OCR技术提取了其它的信息并展示出来。

另外如果想生成对应的对接代码,可以直接复制生成,例如 CURL 的代码如下:

curl -X POST 'https://api.acedata.cloud/identity/idcard/ocr' \
-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/ocr"

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)

自定义信息验证

我们也提供了一种不泄露身份证图片信息的方式来验证,可以只传入姓名name 和 身份证号码 id_card 来进行校验姓名和身份证号的真实性和一致性,下面是填的具体信息:

点击运行后得到如下结果:

{
    "address": "",
    "birth": "",
    "description": "姓名和身份证号一致",
    "id_card": "身份证号码",
    "name": "身份证姓名",
    "nation": "",
    "result": "0",
    "sex": ""
 }

这样从结果看就不会泄露其它隐私信息了,这也可以完成校验姓名和身份证号的真实性和一致性。

错误处理

在调用 API 时,如果遇到错误,API 会返回相应的错误代码和信息。例如:

  • 400 token_mismatched:Bad request, possibly due to missing or invalid parameters.
  • 400 api_not_implemented:Bad request, possibly due to missing or invalid parameters.
  • 401 invalid_token:Unauthorized, invalid or missing authorization token.
  • 429 too_many_requests:Too many requests, you have exceeded the rate limit.
  • 500 api_error:Internal server error, something went wrong on the server.

错误响应示例

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

结论

通过本文档,您已经了解了如何使用 Identity IdCard OCR API 对输入的图片 或 姓名与身份证号码信息来进行校验姓名和身份证号的真实性和一致性。希望本文档能帮助您更好地对接和使用该 API。如有任何问题,请随时联系我们的技术支持团队。

标签:身份证,url,IdCard,身份证号,信息,API,姓名,OCR
From: https://blog.csdn.net/qq_54378726/article/details/141298050

相关文章

  • 使人变老特效——Face ChangeAge API
    FaceChangeAgeAPI对接说明本文将介绍一种通过输入图片和年龄,从而来改变图片中人脸的年龄图片,大致的用法是用户上传一张人脸图片,基于人脸编辑与生成算法,输出一张人脸变老或变年轻的图片,支持实现人脸不同年龄的变化,我们的上游是接入了腾讯云的人脸服务平台API。接下来介......
  • day23-测试自动化之Appium的滑动和拖拽事件、高级手势ActionChains、手机操作API
    目录一、滑动和拖拽事件    1.1.应用场景    1.2.swipe滑动事件    1.3.scroll滑动事件    1.4.drag_and_drop拖拽事件    1.5.滑动和拖拽事件的选择二、高级手势ActionChains    2.1.应用场景    2.2.使用......
  • 006、Vue3+TypeScript基础,组合式API种直接返回渲染内容
    01、App.vue代码如下:<template><divclass="app"><h1>好好学习,天天向上</h1><Person/></div></template><script>//JS或TSimportPersonfrom'./view/PersonNew.vue'exportdefault{......
  • 005、Vue3+TypeScript基础,组合式API给子页面命名的2种方式
    01、App.vue代码如下:<template><divclass="app"><h1>好好学习,天天向上</h1><Person/></div></template><script>//JS或TSimportPersonfrom'./view/PersonNew.vue'exportdefault{......
  • 004、Vue3+TypeScript基础,使用组合式API的写法
    01、App.vue代码如下:<template><divclass="app"><h1>好好学习,天天向上</h1><Person/></div></template><script>//JS或TSimportPersonfrom'./view/PersonNew.vue'exportdefault{......
  • 零成本 API 服务搭建,用 GitHub Actions 自动爬取文章?
    前言本着将成本降到最低,我目前做的应用或小程序都是单机的,也就是不用请求接口,只要一上架就没有任何支出。但是写死的数据毕竟有限,应用的内容单一无法紧跟时事热点,每次打开一个样,自然就没有留存。遇到有错字啥还要更新版本,那有没有方法既能丰富应用内容,又不用增加成本呢?既要又要,......
  • HBase学习的第四天--HBase的进阶与API
    HBase进阶与API一、Hbaseshell1、Region信息观察创建表指定命名空间在创建表的时候可以选择创建到bigdata17这个namespace中,如何实现呢?使用这种格式即可:‘命名空间名称:表名’针对default这个命名空间,在使用的时候可以省略不写create'hbase01:t1','info'此时使用li......
  • PbootCMS用于远程调取系统数据API接口列表
    标签作用:用于远程调取系统数据。使用说明1)请先到后台进行API相关参数配置,强烈建议启用强制认证;2)客户端发起请求必须包含appid(认证用户)、timestamp(时间戳)、signature(签名)三个参数3)签名参数signature通过appid、secret、timestamp三个值连接为一个字符串,然后进行双层md5加密生......
  • API和Web服务
    API(WebAPI)和Web服务(WebService)API和Web服务都是数据交换的方式,但测试方法不同。Web服务通过SOAP或REST协议进行通信,而API是调用约定,更灵活。测试API关注其通信功能,Web服务测试则验证响应。Web服务(WebService)通过使用简单对象访问协议(SOAP)或REST协议来检索所需的数据。SOAP和R......
  • API 接口性能优化管理
    前言国内项目普遍出现工期紧、工作量大、多人协作开发编码习惯不同,能力也参差不齐等多种因素,导致接口在上线后性能不满足预期。本文从接口性能需求分析、接口性能准出标准、接口性能常见问题以及性能优化策略等多个方面,系统地完成接口性能优化的工作。同时在项目交付过程中,......