身份证OCR识别 - 签盾开放平台-公有云版

请求参数

Body 参数application/json

imageBase64

string

身份证图片base64

可选

String 图片的 Base64 值。要求图片经Base64编码后不超过 7M，分辨率建议500*800以上，支持PNG、JPG、JPEG、BMP格式。建议卡片部分占据图片2/3以上。图片的 ImageUrl、imageBase64 必须提供一个，如果都提供，只使用 ImageUrl。

imageUrl

string

身份证图片url

可选

图片的 Url 地址。要求图片经Base64编码后不超过 7M，分辨率建议500*800以上，支持PNG、JPG、JPEG、BMP格式。建议卡片部分占据图片2/3以上。示例值：https://xx/a.jpg

cardSide

string

正反面

可选

FRONT：身份证有照片的一面（人像面）， BACK：身份证有国徽的一面（国徽面），该参数如果不填，将为您自动判断身份证正反面。示例值：FRONT

示例

{
  "imageBase64": "voluptate",
  "imageUrl": "minim Lorem dolor",
  "cardSide": "magna quis dolore occaecat"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'api.pre-qiandun365.com/api/open/idCardOcr' \
--header 'Content-Type: application/json' \
--data-raw '{
    "imageBase64": "voluptate",
    "imageUrl": "minim Lorem dolor",
    "cardSide": "magna quis dolore occaecat"
}'

返回响应

🟢200成功

application/json

Body

code

string

必需

msg

string

必需

result

object

必需

name

string

姓名

必需

人像面

sex

string

性别

必需

人像面

nation

string

民族

必需

人像面

birth

string

出生日期

必需

人像面

address

string

地址

必需

人像面

psnIdCardNum

string

身份证号

必需

人像面

authority

string

发证机关

必需

国徽面

validDate

string

证件有效期

必需

国徽面

logKey

string

必需

ts

string

必需

示例

{
  "result": {
    "name": "胡图图",
    "sex": "男",
    "nation": "汉",
    "birth": "2000/6/21",
    "address": "翻斗大街翻斗花园2号楼1001室",
    "psnIdCardNum": "62***********57",
    "authority": "",
    "validDate": ""
  },
  "code": "200",
  "msg": "成功",
  "logKey": "42d32141",
  "ts": "1716435133757",
  "success": true
}