身份证OCR
POST
/open/api/ocr/idCard
V1.4.1
图片格式为 jpg或png，宽和⾼大于 8px，⼩于等于4000px，大小不能超过1MB
base64 / URL 同时存在时优先URL
请求参数
Body 参数application/json
imageBase64
string
身份证图片的base64编码
imageUrl
string
身份证图片的url地址
cardSide
enum<string>
可选
枚举值:
frontback
示例
{
"imageBase64": "string",
"imageUrl": "string",
"cardSide": "front"
}示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'api.pre-qiandun365.com/api/open/api/ocr/idCard' \
--header 'Content-Type: application/json' \
--data-raw '{
"imageBase64": "string",
"imageUrl": "string",
"cardSide": "front"
}'返回响应
🟢200成功
application/json
Body
result
object
必需
name
string
姓名
sex
string
性别
nation
string
民族
birth
string
出生日期
address
string
地址
psnIdCardNum
string
身份证号码
authority
string
发证机关
validDate
string
证件有效期
code
string
必需
msg
string
必需
logKey
string
必需
ts
string
必需
success
boolean
必需
示例
{
"result": {
"name": "谢勤",
"sex": "男",
"nation": "汉",
"birth": "1997/1/9",
"address": "浙江省平阳县鳌江镇孙岙村四脚亭后路12号",
"psnIdCardNum": "330326199701000000",
"authority": "",
"validDate": ""
},
"code": "200",
"msg": "成功",
"logKey": "89cf48ed",
"ts": "1747362540390",
"success": true
}