# 1 功能描述
本产品提供一站式非证件类图像与文档智能识别服务,支持对各类非证件图片、PDF 文件等进行结构化信息提取与内容解析,覆盖日常单据、票据、表单、合同、纸质文件等多类非证件场景。服务具备高兼容的文件与图像解析能力,支持多页 PDF 识别、图片内容提取、版式还原、文字结构化输出等核心能力,满足海外业务中各类非证件类文档自动化录入、信息提取、资料归档等全场景需求。
# 2 使用说明
# 2.1 调用URL
新加坡地址:https://api-sgp.yljz.com/finauth/v1/anydoc
# 2.2 调用方法
请求方式:POST
请求格式:form-data
说明:客户传入通过apikey和secret生成的加密签名sign,同时提供需识别的文件,我方返回识别结果。
# 3 请求参数
可选/必选
字段
参数类型
参数说明
必选
sign
String
签名生成规则参考鉴权说明
必选
sign_version
String
签名算法版本,请传递:hmac_sha1
必选
file
File
(9M以内),支持图片或PDF,具体以每个应用支持的文档类型为准,图片支持:.jpg, .jpeg, .png, gif, webp格式
可选
inputs
JSON String
依据解析文档类型/app_id而定,需要传入时传入。格式:'inputs':json.dumps({"key":"xxx"}),inputs对应的格式需要是字符串。
必选
app_id
String
不同的识别能力对应不同的app_id,请参考下面的“数据字典”
# 4 返回参数
接口调用成功时返回
字段
类型
参数说明
request_id
String
用于区分每一次请求的唯一的字符串。
error_message
String
错误信息。当请求失败时才会返回此字符串,具体返回内容见后续错误信息章节。否则此字段不存在。
time_used
Int
整个请求所花费的时间,单位为毫秒。
result
Object
不同的app_id/文档类型返回的结构不同,参考“数据字典”
+ pages
Int
消耗的页数,页数*单价就是本次的实际价格,pages大于0/非空时计费
+ outputs
JSON
文档识别结果JSON会封装在outputs中输出
++ text
JSON
这里包含对应appid返回的内容
# 5 数据字典
# 5.1 智慧文档识别能力(app_id)
# 5.2 各能力对应识别返回结果说明
# 图片质量检测 builtin-ySmthSJqzQ3bN0Z9Y0
字段名
类型
中文说明
示例
quality
Integer
图片质量:1=关键视觉信息清晰可辨,0=关键视觉信息模糊不清、难以辨认或无法可靠识别
1
issues
String
质量问题枚举:1=模糊或分辨率低或失焦,2=眩光,3=太暗,4=太亮,5=其他质量问题
["1","3"]
# 图片PS检测 builtin-lcDhAaeQMJcOandoBP
字段名
类型
中文说明
示例
is_tampered
Boolean
布尔值为真时表示存在篡改,否则表示未检测到篡改痕迹
false
tampered_positions
Array
篡改位置:每个元素代表文档中一个被篡改的矩形区域,八个数字分别对应四角坐标——左上角、右上角、右下角、左下角;一个文档中可能存在多个被篡改区域
[366,404,409,404,409,431,366,431]
# 简版通用水电煤燃气账单 builtin-0nZ0bZ09s9HqfjckoF
# 详版燃气账单 builtin-8qUxGuXkYTm4U3lLxb
字段名
类型
中文说明
示例
BillingCompany
String
开具账单的燃气公司
Petrotrade
CustomerName
String
客户全名
Jack
Address
String
街道地址
29.88 Road
CurrentReading
Number
当前的计量表读数
234
PreviousReading
Number
上次的计量表读数
188
Consumption
Number
燃气消耗量
46
NumberOFBills
Number
包含的账单数量
2
AmountDue
Number
总应缴金额
230
AmountInWords
String
大写金额
Two hundred and thirty
BillingPeriodFrom
String
计费周期的开始日期(年-月)
2025-01
BillingPeriodTo
String
计费周期的结束日期(年-月)
2025-02
BillId
String
账单参考编号
123456789012
IssueDate
String
发行日期(年-月-日 时:分:秒)
2025-02-03 11:22:33
CollectorName
String
收银员/收款人姓名
Mary
City
String
客户所在城市
Beijing
Branch
String
分支机构/中心
Chaoyang
PaymentType
String
支付方式(现金、信用卡等)
cash
# 详版电费单 builtin-u6OXNzMM68cMyqfCH8
字段名
类型
中文说明
示例
BillingCompany
String
开具账单的电力公司的名称
Horth Catto Electricity Distribution Co.
TaxNumber
String
公司的税务登记号码
156-176-210
BillID
String
账单的参考编号或唯一标识符
b9036650afbf4ft
PaymentCode
String
用于付款的代码
01344519012500
IssueDate
String
账单开具日期(年-月-日)
2025-04-13
City
String
客户所在城市
Beijing
Area
String
行政区域/管理单位
Chaoyang
CustomerName
String
账单接收者的全名
Jack
Address
String
客户的街道地址
24.56 Road
Description
String
如公寓、楼层或位置描述等的附加地址详情
Floor 3
MeterNumber
String
电表的唯一编号
6154005
CurrentReading
Number
电表的当前读数
254717
PreviousReading
Number
电表的上一次读数
413
Consumption
Number
该时间段内的用电量
254304
NumberOfBills
Number
此账单中包含的账单数量
1
AmountDue
Number
当前计费周期内的应缴金额
580
TotalPaid
Number
客户支付的总金额
580
AmountInWords
String
客服支付的金额(大写)
Five hundred and eighty
# M-PESA流水证明 builtin-yQU9ZpfsRuFeNUy4aw
# 银行流水识别 builtin-Dr2fttpaJzyOg2oGYZ
# 非标交易流水识别 builtin-ftEObTXXN9m03VXmwZ
说明:返回数据为对象(Object)结构,包含流水头部信息和交易明细。其中 transactions 为交易明细数组,每个元素代表一条交易记录;otherHeadings 为除常规头部字段外的扩展字段对象,不同流水文档返回的字段可能不同。
字段名
类型
中文说明
示例
title
string
银行流水标题或账户页面标题。若不存在或无法识别,返回空字符串。
easypaisa Account
accountHolder
string
账户持有人姓名。若不存在或无法识别,返回空字符串。
SAMI ULLAH
accountNo
string
银行账号或账户号码。若不存在或无法识别,返回空字符串。
03430281764
cardNo
string
银行卡号。若不存在或无法识别,返回空字符串。
6222021234567890
institution
string
银行、电子钱包或其他金融机构名称。若不存在或无法识别,返回空字符串。
easypaisa
currency
string
账户币种。可返回币种名称或 ISO 4217 币种代码;若不存在或无法识别,返回空字符串。
PKR
iban
string
国际银行账户号码(IBAN)。若不存在或无法识别,返回空字符串。
PK88TMFB0000000063778775
fromDate
string
流水起始日期,格式为 YYYY-MM-DD。若不存在或无法识别,返回空字符串。
2026-05-01
toDate
string
流水结束日期,格式为 YYYY-MM-DD。若不存在或无法识别,返回空字符串。
2026-05-31
otherHeadings
object
其他顶部信息,以动态键值对形式返回。对象中的每一项均为一组“字段名称: 字段值”;字段名称和数量不固定。若无其他顶部信息,返回空对象 {}。
{"Contact Number":"03430281764","Email":"samiullahb726@gmail.com"}
+动态键值对
string
key 为银行流水中识别到的原始字段名称,value 为对应字段内容。不同银行、国家和流水模板可能返回不同的 key。
"Contact Number": "03430281764"
transactions
array
交易明细数组。每个元素代表一条交易记录;若未识别到有效交易记录,返回空数组 []。
[{"time":"2026-05-24 18:31:00","amount":"-300.00","party":"MUHAMMAD ANAS TAQI","balance":"112520.83"}]
+time
string
交易时间。支持格式:YYYY-MM-DD、YYYY-MM-DD HH:MM:SS、HH:MM:SS。若时间不可见或无法识别,返回空字符串。
2026-05-24 18:31:00
+amount
string
交易金额。不包含币种、货币符号和千分位分隔符。收入使用正号 +,支出使用负号 -。若金额不可见或无法识别,返回空字符串。
-300.00
+party
string
交易对手方名称。仅提取明确可见的个人姓名、商户名、公司名等;若无明确交易对手方或无法判断,返回空字符串。
MUHAMMAD ANAS TAQI
+balance
string
交易后余额。不包含币种、货币符号和千分位分隔符。若交易后余额不可见或无法识别,返回空字符串。
112520.83
# 企业注册登记证明 builtin-siyppaCoUSYW1VImX9
# 购物小票识别 builtin-AsGltresBLOGouN1Pr
# 发票识别 builtin-FgYvNQQFGQ3o7qBVOe
# 贸易单据识别 builtin-SZ7arhpW9ggiYx8Mtv
语言编码遵循 ISO 639-1 两位字母语言编码标准,如英文:en; 中文:zh; 法文:fr;德文:de;日文:ja;泰文:th; 越南文:vi;阿拉伯文:ar等
# 物流单据识别 builtin-9h46zxVymyKPBaxz0J
该接口用于提取物流单据中的核心运输信息,包括运输方式、交货方式、物流单号及物流公司。所。
字段名
类型
中文说明
示例
tMode
String
运输方式。可选值:sea(海运)、air(空运)、road(公路运输)、rail(铁路运输)、courier(快递/快件)、other(其他)
sea
dMode
String
交货方式,按单据原文返回
"Port-To-Port" or "Combined Transport"
logNo
String
物流单号
MEDURC329246
carrier
Array
物流公司/承运商名称列表
["马士基航运有限公司", "Maersk A/S"]
# 报关单识别 builtin-CCEBCCjsTt54IgtF1x
该接口用于提取全球报关单中的核心申报信息,包括海关编号、出口报关金额及对应币种。所有字段固定返回;无值时返回空字符串 ""。其中币种使用 ISO 4217 标准币种代码。
字段名
类型
中文说明
示例
customsNo
String
海关编号/海关参考编号
25CN1234567890ABC
amount
String
出口报关金额,仅返回数字;原金额含小数时保留小数位,不含小数时返回整数形式,不包含千分位分隔符及币种符号
12500.00
currency
String
出口报关金额对应币种,使用 ISO 4217 标准币种代码
USD
# 通用护照识别 builtin-GehZrc2wddibKXSAWb
字段名
类型
中文说明
示例
countryCode
String
国家代码
CHN
passportNumber
String
护照号码
E40898665
fullNameLocal
String
全名,使用当地语言表示
张三
fullNameLatin
String
全名,使用英语拉丁字符表示
ZHANG SAN
surname
String
姓
ZHANG
givenName
String
名
SAN
middleName
String
中间名
null
nationality
String
国籍
CHINESE
dateOfBirth
String
出生日期,格式为YYYY-MM-DD
2009-09-09
sex
String
性别,F=女,M=男
F
placeOfBirth
String
出生地
河北
placeOfIssue
String
发证地
河北
dateOfIssue
String
发证日期,格式为YYYY-MM-DD
2015-01-06
dateOfExpiry
String
失效日期,格式为YYYY-MM-DD
2020-01-05
issuingAuthority
String
发证机关
公安部出入境管理局
isPP
Boolean
是否为护照,true=是,false=否
true
# 全球卡证出生日期与年龄解析 builtin-reKEg1UVsgE5yGtNO7
字段名
类型
中文说明
示例
dob
string
持证人的出生日期,统一转换为公历(Gregorian Calendar)格式,输出 YYYY-MM-DD;无法识别时返回空字符串 ""
1976-06-18
adult
boolean
是否已满 18 周岁;true 表示已成年,false 表示未成年;当 dob 为空时返回空字符串 ""
true
age
object
持证人的年龄,按完整经过的年、月计算;不足一个完整月不进位;当 dob 为空时返回空字符串 ""
{"years":50,"months":1}
+years
integer
已完整经过的年龄(年)
50
+months
integer
已完整经过的月份(0~11),不足一个完整月不进位
1
# 中国台湾物权证 builtin-nGd1eMoYS2mBKgjYQ6
字段名
类型
中文说明
示例
certNo
String
建筑物所有权的证书编号
108北士字第000001号
owner
String
建筑物所有者的姓名(个人或组织)
张三
ownerId
String
所有者的统一识别号码(类似于个人身份证号码或公司注册号码)
1234567890123
lot
String
建筑物登记的地块编号或地籍位置
朝阳区0001
houseNo
String
建筑物的房屋编号
幸福路123号三楼
floor
String
建筑物的楼层或级别描述
三层
# 中国台湾不动产权证 builtin-ZXELuKZ7SXPGWmixZE
字段名
类型
中文说明
示例
name
String
证书持有者的中文姓名
张三
id
String
证书持有者的台湾身份证号码
A123456789
bDateTw
String
以台湾地区格式表示的出生日期,格式为”民國年 月**日“
民國70年05月12日
bDate
String
以年-月-日格式表示的出生日期
1981-05-12
certNo
String
证书编号
(xx)XX字第XXX號
issDateTw
String
以台湾地区格式表示的证书颁发日期,格式为”民國年 月**日“
民國70年05月12日
issDate
String
以年-月-日格式表示的证书颁发日期
1981-05-12
issuer
String
颁发机构的名称或地点
高雄市政府地政局
# 中国台湾身份证 builtin-SrFi52OPlDGKSQmjvZ
字段名
类型
中文说明
示例
name
string
持证人姓名
林小明
dateOfBirth
string
持证人出生日期,按证件原始格式返回
民國72年1月1日
gender
string
持证人性别
男
issueDate
string
证件发证日期,按证件原始格式返回;如包含发证地区、换发/补发等备注信息,一并返回
民國107年10月15日(北市)换發
nationalID
string
台湾身份证统一编号
A123456789
# 中国台湾居民居住在 builtin-UqDwMvWDRD05zCm0BG
字段名
类型
中文说明
示例
name
string
持证人姓名
张三
gender
string
持证人性别,男/女
男
dob
string
持证人出生日期,格式为YYYY-MM-DD
2000-01-01
address
string
持证人居住地址
北京市朝阳区xxx号
no
string
台湾居民居住证号码
12345678901234567
issAuthority
string
证件签发机关
北京市朝阳区和平分局
issDate
string
证件签发日期,格式为YYYY-MM-DD
2019-01-01
expiryDate
string
证件有效期截止日期,格式为YYYY-MM-DD
2024-01-01
renew
string
换发次数或续签次数
01
permitNo
string
台湾居民来往大陆通行证号码
12345678
# 中国香港多卡证识别 builtin-a5M4RsfCIdCSB7YPHS
卡证类型:HKID=香港身份证,DRIVER_LICENSE=香港驾驶执照,VEHICLE_REGISTRATION=香港车辆登记文件,BUSINESS_REGISTRATION=香港商业/分行登记证,MAINLAND_TRAVEL_PERMIT=港澳居民来往内地通行证,OTHER=其他或无法确定
卡证类型
字段
类型
正面/反面
含义
输出示例
全部
cardType
string
通用
卡证类型:HKID=香港身份证,DRIVER_LICENSE=香港驾驶执照,VEHICLE_REGISTRATION=香港车辆登记文件,BUSINESS_REGISTRATION=香港商业/分行登记证,MAINLAND_TRAVEL_PERMIT=港澳居民来往内地通行证,OTHER=其他或无法确定
HKID
HKID
permanent
string
正面
是否为香港永久性居民身份证:true=是,false=否;无法判断时返回空字符串
true
HKID
cnName
string
正面
中文姓名,保留卡面原始文字和顺序
谷燕燕
HKID
enName
string
正面
英文姓名,保留大小写、标点和顺序
KU, Yin Yin
HKID
telegraphCode
string
正面
中文姓名电码,保留卡面数字分组
6666 4666 3666
HKID
dob
string
正面
出生日期,格式为 YYYY-MM-DD
1988-08-10
HKID
gender
string
正面
性别:M=男,F=女
F
HKID
symbol
string
正面
身份证符号,保留星号及字母
***AZ
HKID
issDate
string
正面
当前登记或签发日期,格式为 YYYY-MM-DD
2005-08-05
HKID
firstIssDate
string
正面
首次登记年月,格式为 YYYY-MM
1989-04
HKID
no
string
正面
香港身份证号码,保留括号内校验码
K808080(8)
DRIVER_LICENSE
no
string
正面
驾驶执照号码,保留字母、数字、括号和前导零
Y123456(7)
DRIVER_LICENSE
cnName
string
正面
持证人中文姓名
梁嘉俊
DRIVER_LICENSE
enName
string
正面
持证人英文姓名,保留卡面顺序和标点
LEUNG, KA CHUN
DRIVER_LICENSE
fullClasses
string
正面
正式执照类别代码,多个类别使用空格连接
1 2 18 19 20 21
DRIVER_LICENSE
fullExpiryDate
string
正面
与正式执照类别同一行的有效日期,格式为 YYYY-MM-DD
2033-01-12
DRIVER_LICENSE
learnerClasses
string
正面
学习执照类别代码,多个类别使用空格连接
4 5 9 10
DRIVER_LICENSE
learnerExpiryDate
string
正面
与学习执照类别同一行的有效日期,格式为 YYYY-MM-DD
2026-03-20
DRIVER_LICENSE
probationaryClasses
string
正面
暂准执照类别代码,多个类别使用空格连接
3 22
DRIVER_LICENSE
probationaryExpiryDate
string
正面
与暂准执照类别同一行的有效日期,格式为 YYYY-MM-DD
2026-03-16
DRIVER_LICENSE
restrictions
string
正面
限制事项代码,多个代码使用空格连接
9
DRIVER_LICENSE
refNo
string
正面
驾驶执照参考编号
A33-0034-120122
VEHICLE_REGISTRATION
docNo
string
正面
文件右下角 NO. 后的文件编号,不包含 NO.
T 335099
VEHICLE_REGISTRATION
regMark
string
正面
车辆登记号码,即车牌号码,不包含旁边的校验字符
SL8182
VEHICLE_REGISTRATION
regMarkCheckDigit
string
正面
登记号码框旁单独印刷的校验字符
6
VEHICLE_REGISTRATION
class
string
正面
车辆类别
PRIVATE CAR
VEHICLE_REGISTRATION
make
string
正面
车辆厂牌
MERCEDES BENZ
VEHICLE_REGISTRATION
model
string
正面
车辆型号
SLK250 BLUEEFFICIENCY (R172)
VEHICLE_REGISTRATION
chassisNo
string
正面
底盘号码或车辆识别号码
WDD1724472F089968
VEHICLE_REGISTRATION
engineNo
string
正面
引擎号码
27186130748174
VEHICLE_REGISTRATION
fuelType
string
正面
燃料类型,按文件原文返回
PETROL
VEHICLE_REGISTRATION
cylinderCap
string
正面
汽缸容量,通常对应文件中的数值部分
1796
VEHICLE_REGISTRATION
ratedPower
string
正面
额定功率
110
VEHICLE_REGISTRATION
colour
string
正面
车辆颜色
BLACK
VEHICLE_REGISTRATION
bodyType
string
正面
车身类型
CONVERTIBLE
VEHICLE_REGISTRATION
typeApprovalNo
string
正面
车型审核编号
B0160000
VEHICLE_REGISTRATION
manufactureYear
string
正面
出厂年份,格式为四位年份
2014
VEHICLE_REGISTRATION
origin
string
正面
原产国家或地区,按文件原文返回
GERMANY
VEHICLE_REGISTRATION
firstRegDate
string
正面
首次登记日期,格式为 YYYY-MM-DD
2014-04-23
VEHICLE_REGISTRATION
firstRegStatus
string
正面
首次登记时的车辆状况
BRAND NEW VEH.
VEHICLE_REGISTRATION
firstRegTaxableValue
string
正面
首次登记时的应课税价值,保留货币符号
$353250.00
VEHICLE_REGISTRATION
firstRegTaxPaid
string
正面
已缴付的首次登记税,保留货币符号
$225750.00
VEHICLE_REGISTRATION
taxExemptAccessoryValue
string
正面
免税配件价值,保留货币符号
$0.00
VEHICLE_REGISTRATION
unexpiredTaxExemptWarrantyValue
string
正面
免税保养未满期部分的价值,保留货币符号
$0.00
VEHICLE_REGISTRATION
prevOwnerCount
string
正面
之前车主数目
0
VEHICLE_REGISTRATION
ownerRegDate
string
正面
登记为当前车主的日期,格式为 YYYY-MM-DD
2014-04-23
VEHICLE_REGISTRATION
licenceConditions
string
正面
牌照条件,按文件原文返回
VEHICLE_REGISTRATION
remarks
string
正面
附注,按文件原文返回
VEHICLE_REGISTRATION
ownerIdNo
string
正面
登记车主的身份证明文件号码
K808080(8)
VEHICLE_REGISTRATION
ownerName
string
正面
登记车主姓名;不得提取右下角运输署长官或签署人员姓名
LEE Tin-chi
VEHICLE_REGISTRATION
issDate
string
正面
文件发出日期,格式为 YYYY-MM-DD
2025-03-24
VEHICLE_REGISTRATION
transactionNo
string
正面
交易记录编号
C42-0078
BUSINESS_REGISTRATION
certNo
string
正面
商业/分行登记证号码,保留字母、数字、连字符和前导零
25314389-000-08-25-0
BUSINESS_REGISTRATION
cnName
string
正面
业务或法团的中文名称
溢怡即食海参公司
BUSINESS_REGISTRATION
enName
string
正面
业务或法团的英文名称,多行使用一个空格连接
CANERLEY SEA CUCUMBER INSTANT FOOD COMPANY
BUSINESS_REGISTRATION
cnBranchName
string
正面
中文业务或分行名称;与法团名称分开提取
九龙分行
BUSINESS_REGISTRATION
enBranchName
string
正面
英文业务或分行名称;与法团名称分开提取
KOWLOON BRANCH
BUSINESS_REGISTRATION
address
string
正面
登记营业地址,多行地址按顺序使用一个空格连接
15F JUNIPER MANSION TAIT KOO SHING HK
BUSINESS_REGISTRATION
bizNature
string
正面
业务性质,按证件原文返回
售卖即食海参饮品和食品
BUSINESS_REGISTRATION
status
string
正面
法律地位,按证件原文返回
INDIVIDUAL
BUSINESS_REGISTRATION
commencementDate
string
正面
生效日期,格式为 YYYY-MM-DD
2025-08-02
BUSINESS_REGISTRATION
expiryDate
string
正面
届满日期,格式为 YYYY-MM-DD
2026-08-01
MAINLAND_TRAVEL_PERMIT
no
string
正面
通行证证件号码,不包含换证次数
H12345678
MAINLAND_TRAVEL_PERMIT
renewalCount
string
正面
两位换证次数,保留前导零
04
MAINLAND_TRAVEL_PERMIT
cnName
string
正面
通行证上的中文姓名
刘芷兰
MAINLAND_TRAVEL_PERMIT
enName
string
正面
通行证上的英文姓名,保留大小写、标点和顺序
LAU, TSZ LAN
MAINLAND_TRAVEL_PERMIT
dob
string
正面
出生日期,格式为 YYYY-MM-DD
1981-08-03
MAINLAND_TRAVEL_PERMIT
gender
string
正面
性别:M=男,F=女
F
MAINLAND_TRAVEL_PERMIT
nationality
string
正面
非中国籍版本上的国籍,按证件原文返回
CANADA
MAINLAND_TRAVEL_PERMIT
issDate
string
正面
有效期限中的开始日期,格式为 YYYY-MM-DD
2012-12-12
MAINLAND_TRAVEL_PERMIT
expiryDate
string
正面
有效期限中的结束日期,格式为 YYYY-MM-DD
2022-12-11
MAINLAND_TRAVEL_PERMIT
issAuthority
string
正面
签发机关,按证件原文返回
公安部出入境管理局
MAINLAND_TRAVEL_PERMIT
localIdName
string
反面
香港或澳门身份证件上的姓名;不得使用正面姓名补全
劉芷蘭
MAINLAND_TRAVEL_PERMIT
localIdNo
string
反面
香港或澳门身份证件号码
K808080(8)
MAINLAND_TRAVEL_PERMIT
permitHistory
string
反面
曾持证或持证历史信息,按原文完整返回
H87654321 02
MAINLAND_TRAVEL_PERMIT
stayLimit
string
反面
非中国籍版本反面的停留期限信息,按原文返回
每次停留不超过90日
MAINLAND_TRAVEL_PERMIT
line1
string
反面
机读区第一行,保留所有字母、数字及 <,不插入空格
CSCNTH123456789<<<<<<<<
MAINLAND_TRAVEL_PERMIT
line2
string
反面
机读区第二行,保留所有字母、数字及 <,不插入空格
8108035F2212119CHN<<<<<<
MAINLAND_TRAVEL_PERMIT
line3
string
反面
机读区第三行,保留所有字母、数字及 <,不插入空格
LAU<<TSZ<LAN<<<<<<<<<<<<
# 菲律宾多证件识别 builtin-laCUS0pQTRGOrEas0l
图片质量与人脸检测相关能力默认不返回,需要联系商务人员开启权限。
卡证类型
字段
类型
含义
输出示例
全部
cardType
string
卡证类型,UMID=统一多用途身份证,SSS_ID=社会保障系统编号,PASSPORT=护照,DRIVER_LICENSE=驾驶证,NATIONAL_ID=国家身份证,POSTAL_ID=邮政身份证,PRC_ID=专业注册委员会身份证,TIN_ID=纳税人身份证,VOTER_ID=选民证,OWWA_ID=海外劳工福利署身份证,GSIS_ID=政府服务保险系统身份证,PHILHEALTH_ID=菲律宾健康保险身份证,PAGIBIG_ID=Pag-IBIG住房公积金会员身份证
UMID
UMID
crn
string
卡号 / CRN
0020-1215160-9
UMID
surname
string
姓
SANTOS
UMID
givenName
string
名
JOSE
UMID
middleName
string
中间名
CRUZ
UMID
fullName
string
全名组合(given + middle + surname)
JOSE CRUZ SANTOS
UMID
gender
string
性别
M / F
UMID
dob
string
出生日期,YYYY-MM-DD
1960-01-28
UMID
address
string
全部地址,多行合并
28 PAYAPA ST BAGONG DIWA STO CRISTOBAL CALOOCAN CITY METRO MANILA PHILIPPINES 1800
SSS_ID
no
string
社会保险号
02-2102579-6
SSS_ID
name
string
全名
MARVIN GALANG PANGAN
SSS_ID
dob
string
出生日期,YYYY-MM-DD
1984-12-13
PASSPORT
country
string
ISO 国家代码
PHL
PASSPORT
type
string
护照类型
P
PASSPORT
no
string
护照号
P1234567
PASSPORT
nameLocal
object
本地姓名结构
{full, surname, givenName, middleName}
PASSPORT
nameLatin
object
拉丁姓名结构
{full, surname, givenName, middleName}
PASSPORT
nationality
string
国籍
Filipino
PASSPORT
dob
string
出生日期,YYYY-MM-DD
1990-01-01
PASSPORT
sex
string
性别
M / F
PASSPORT
pob
string
出生地
QUEZON CITY
PASSPORT
issPlace
string
签发地
null
PASSPORT
issDate
string
签发日期,YYYY-MM-DD
2015-06-01
PASSPORT
expiryDate
string
到期日期,YYYY-MM-DD
2025-06-01
PASSPORT
issAuthority
string
签发机关
DFA Manila
PASSPORT
MRZ
object
机读区
{line1, line2}
DriverLicense
name
string
全名
DELA CRUZ, JUAN PEDRO GARCIA
DriverLicense
nationality
string
国籍
PHL
DriverLicense
gender
string
性别
M / F
DriverLicense
dob
string
出生日期,YYYY-MM-DD
1995-08-15
DriverLicense
weight
string
体重(kg)
60
DriverLicense
height
string
身高(m)
1.70
DriverLicense
address
string
地址,多行合并
1123 YOUR ADDRESS, MANILA, 1008 METRO MANILA, PHILIPPINES
DriverLicense
no
string
驾照号
D23-52 867231
DriverLicense
expiryDate
string
到期日期,YYYY-MM-DD
2024-04-11
DriverLicense
agencyCode
string
发证机构代码
D24
DriverLicense
bloodType
string
血型
A+
DriverLicense
eyesColor
string
眼睛颜色
BLACK
DriverLicense
restrictions
string
驾照限制
1,2
DriverLicense
conditions
string
驾照条件
NONE
NATIONAL_ID
no
string
PhilSys 卡号 / 主 ID
1234-5678912-3
NATIONAL_ID
givenName
string
名
JUAN
NATIONAL_ID
middleName
string
中间名
MARTINEZ
NATIONAL_ID
surname
string
姓
DELA CRUZ
NATIONAL_ID
gender
string
性别
M / F
NATIONAL_ID
dob
string
出生日期,YYYY-MM-DD
1990-01-01
NATIONAL_ID
pob
string
出生地
QUEZON CITY
NATIONAL_ID
blood
string
血型
O
NATIONAL_ID
marital
string
婚姻状况
Single
NATIONAL_ID
address
string
地址,多行合并
01 SAMPALOC, MANILA CITY, METRO MANILA
NATIONAL_ID
issDate
string
签发日期,YYYY-MM-DD
2015-06-01
PostalID
no
string
邮政身份证号 / PRN
CA314000001-B
PostalID
name
string
全名
MA. JOSEFINA M. DELA CRUZ
PostalID
address
string
地址,多行合并
662 Mendoza St. Lolomboy Bocaue Bulacan 3018
PostalID
dob
string
出生日期,YYYY-MM-DD
1958-02-24
PostalID
nationality
string
国籍
Filipino
PostalID
expiryDate
string
到期日期,YYYY-MM-DD
2017-11-04
PostalID
issOffice
string
发证邮局
MNL CPO
PRCID
lastName
string
姓
DUMANDAN
PRCID
firstName
string
名
GLORIO JR
PRCID
middleName
string
中间名
ORTEGA
PRCID
regNo
string
注册号
003978
PRCID
regDate
string
注册日期,YYYY-MM-DD
2008-10-30
PRCID
expiryDate
string
到期日期,YYYY-MM-DD
2011-05-16
PRCID
profession
string
职业 / 专业
CRIMINOLOGIST
TIN_ID
name
string
持证人姓名
DELA CRUZ, JUAN
TIN_ID
tin
string
纳税人识别号
123-456-789-000
TIN_ID
address
string
持证人地址
28 Payapa St. Bagong Diwa Sto. Cristobal, Caloocan City
TIN_ID
dob
string
出生日期,YYYY-MM-DD
1994-09-04
TIN_ID
issDate
string
签发日期,YYYY-MM-DD
2017-10-02
VOTER_ID
vin
string
选民识别号 VIN
7404-2491C-D2843TPR10000
VOTER_ID
name
string
持证人姓名
REYES TEODORO PANGLINAN
VOTER_ID
dob
string
出生日期,YYYY-MM-DD
1943-04-26
VOTER_ID
status
string
婚姻状态,按卡面原文返回
Married
VOTER_ID
citizenship
string
公民身份/国籍
Filipino
VOTER_ID
address
string
持证人地址
B17 L21 VILLANOVA SUBD., NAGKAISANG NAYON
VOTER_ID
precinct
string
投票区编号 / Precinct No.
2491C
VOTER_ID
issDate
string
签发或登记日期,YYYY-MM-DD
2023-11-29
OWWA_ID
name
string
持证人姓名
REYES TEODORO PANGLINAN
OWWA_ID
dob
string
出生日期,YYYY-MM-DD
1982-10-05
OWWA_ID
gender
string
性别,M/F
M
OWWA_ID
address
string
持证人地址
B17 L21 VILLANOVA SUBD., NAGKAISANG NAYON
OWWA_ID
no
string
OFW ID / OFW e-CARD 号码
OWWA000001
OWWA_ID
issDate
string
签发日期,YYYY-MM-DD
1982-10-05
GSIS_ID
name
string
持证人姓名
JUANA DE LA CRUZ
GSIS_ID
no
string
GSIS号码
123456789012
GSIS_ID
bankNo
string
银行卡号
4000 0076 1978 0014
GSIS_ID
dob
string
出生日期,YYYY-MM-DD
1960-01-28
GSIS_ID
gender
string
性别,M/F
F
GSIS_ID
address
string
持证人地址
28 Payapa St. Bagong Diwa Sto. Cristobal Caloocan City, MM 1800
GSIS_ID
validThru
string
有效期;精确到月返回 YYYY-MM,精确到日返回 YYYY-MM-DD
2008-09
PHILHEALTH_ID
name
string
持证人姓名
DARIO, ANDINO BALANA
PHILHEALTH_ID
no
string
PhilHealth卡号 / PIN
02-050329439-8
PHILHEALTH_ID
dob
string
出生日期,YYYY-MM-DD
1987-04-05
PHILHEALTH_ID
gender
string
性别,M/F
M
PHILHEALTH_ID
address
string
持证人地址
29 B5 SITIO MA CORAZON PH2 SANTA CRUZ ANTIPOLO CITY, RIZAL - 1870
PAGIBIG_ID
name
string
持证人姓名
JUANA A. DELA CRUZ
PAGIBIG_ID
no
string
Pag-IBIG MID号码 / 会员编号
1023-4567-8090
全部
faces
array
卡证图片中检测到的人脸位置列表;支持多张人脸,未检测到人脸时返回 []
[{"width":0.15498,"top":0.59956,"left":0.12833,"height":0.24289}]
全部
faces.width
float
人脸框宽度,占原图宽度的比例
0.15498
全部
faces.top
float
人脸框左上角纵坐标,占原图高度的比例
0.59956
全部
faces.left
float
人脸框左上角横坐标,占原图宽度的比例
0.12833
全部
faces.height
float
人脸框高度,占原图高度的比例
0.24289
全部
faces.face_quality
float
人脸图质量得分,0-100,建议参考阈值30.1以上为质量合规
90.09094250091916
全部
quality
string
图片质量总体辅助判定;1 表示关键视觉信息基本清晰可用,0 表示可能存在影响识别或使用的问题,建议人工复查
1
全部
issues
array
图片质量问题列表;1 模糊低分辨率,2 反光,3 过暗,4 过亮,5 屏幕翻拍,6 卡证不完整/破损,7 卡证遮挡/涂抹;无问题返回 []
["6"]
# 巴基斯坦多卡证识别 builtin-5Rfhqo1A3MGROHUNJJ
支持识别5类巴基斯坦身份证件:cnic(Computerized National Identity Card)、snic(Smart National Identity Card)、nicop(National Identity Card for Overseas Pakistanis)、poc(Pakistan Origin Card)、arc(Alien Registration Card),上述类型之外的识别为other(其他)。
字段名
类型
中文说明
所属卡证
示例
no
string
持证人身份证号码
5类卡证正面
34101-5378249-5
name
string
持证人姓名(英文)
5类卡证正面
Adeel Sajjad
fatherName
string
持证人父亲姓名(英文);如无可为空字符串
5类卡证正面
Sajjad Ahmed
husbandName
string
持证人配偶姓名(英文,仅适用于已婚女性);如无可为空字符串
5类卡证正面
gender
string
持证人性别;可选值 M(男性)、F(女性)、X(第三性别)
5类卡证正面
M
dob
string
持证人出生日期,格式 YYYY-MM-DD
5类卡证正面
2000-08-12
countryOfStay
string
持证人当前居住国家
5类卡证正面
Pakistan
issDate
string
证件签发日期,格式 YYYY-MM-DD
niocp的背面,其余4类卡证的正面
2024-11-17
expiryDate
string
证件有效期截止日期,格式 YYYY-MM-DD
niocp的背面,其余4类卡证的正面
2034-11-17
presentAddress
string
当前居住地,多为乌尔都语
5类卡证的背面
permanentAddress
string
永久居住地,多为乌尔多语
5类卡证的背面
type
string
"cnic":Computerized National Identity Card,巴基斯坦境内公民身份证。正面无芯片,卡面内容通常为乌尔都语。 "snic":Smart National Identity Card,带芯片的巴基斯坦智能公民身份证。正面包含芯片。"nicop":National Identity Card for Overseas Pakistanis,海外巴基斯坦公民身份证。 "poc":Pakistan Origin Card,面向具有巴基斯坦血统或联系的外国公民。"arc":Alien Registration Card,面向在巴基斯坦登记的外国人。 "other":上述之外的其他类型。
---
snic
# 东帝汶多卡证识别 builtin-6UOFfK0g1gMvgCHx19
卡证类型
字段名
类型
中文说明
示例
CITIZEN_CARD
cardType
string
证件类型,固定返回 CITIZEN_CARD
CITIZEN_CARD
CITIZEN_CARD
no
string
公民身份证号码,通常对应 No BI / Card No、No BI 或 Card No
0600506125463002
CITIZEN_CARD
name
string
持证人姓名,通常对应 Nome do Titular / Full Name
MARIA DA SILVA
CITIZEN_CARD
marital
string
婚姻状态,通常对应 Estado Civil / Marital Status
CASADO
CITIZEN_CARD
gender
string
持证人性别;可选值 M、F
F
CITIZEN_CARD
height
string
身高,不包含单位
155
CITIZEN_CARD
dob
string
出生日期,格式为 YYYY-MM-DD
1990-05-12
CITIZEN_CARD
pob
string
出生地,通常对应 Naturalidade / Place of Birth
DILI
CITIZEN_CARD
nationality
string
国籍,通常对应 Nacionalidade / Nationality
TIMORENSE
CITIZEN_CARD
fatherName
string
父亲姓名;如父母姓名未明确区分,通常取父母信息中的第一行
JOSE DA SILVA
CITIZEN_CARD
motherName
string
母亲姓名;如父母姓名未明确区分,通常取父母信息中的第二行
ANA MARIA
CITIZEN_CARD
address
string
居住地址,通常对应 Residência / Address
DILI, TIMOR-LESTE
CITIZEN_CARD
issDate
string
签发日期,格式为 YYYY-MM-DD
2020-01-15
CITIZEN_CARD
expiryDate
string
有效期截止日期,格式为 YYYY-MM-DD
2030-01-15
DRIVING_LICENSE
cardType
string
证件类型,固定返回 DRIVING_LICENSE
DRIVING_LICENSE
DRIVING_LICENSE
no
string
驾驶证号码或卡号,通常对应 No CC 等字段
03029/DNTT/C/IV/09
DRIVING_LICENSE
name
string
持证人姓名
JOAO PEREIRA
DRIVING_LICENSE
nationality
string
证件中显示的国籍或出生地信息,按原文返回
TIMOR-LESTE
DRIVING_LICENSE
dob
string
出生日期,格式为 YYYY-MM-DD
1988-03-20
DRIVING_LICENSE
address
string
持证人地址,通常对应 Morada
DILI
DRIVING_LICENSE
gender
string
持证人性别;可选值 M、F
M
DRIVING_LICENSE
eyes
string
眼睛颜色,通常对应 Olhos
Castanhos
DRIVING_LICENSE
height
string
身高,按证件显示返回,不包含单位
180
DRIVING_LICENSE
blood
string
血型,通常对应 G. Sanguineo
O
DRIVING_LICENSE
issDate
string
签发日期,格式为 YYYY-MM-DD
2016-04-10
DRIVING_LICENSE
expiryDate
string
有效期截止日期,格式为 YYYY-MM-DD
2026-04-10
PASSPORT
cardType
string
证件类型,固定返回 PASSPORT
PASSPORT
PASSPORT
country
string
签发国家 ISO 3166-1 alpha-3 代码
TLS
PASSPORT
Type
string
护照类型,如普通护照、外交护照等类型代码
P
PASSPORT
no
string
护照号码
P1234567
PASSPORT
surname
string
持证人姓氏/家族名,按护照可见内容返回
GUTERRES
PASSPORT
givenName
string
持证人名字,按护照可见内容返回
JOSE
PASSPORT
nationality
string
国籍,按护照可见内容返回
TIMORESE
PASSPORT
dob
string
出生日期,格式为 YYYY-MM-DD
1990-06-15
PASSPORT
sex
string
持证人性别;可选值 M、F
M
PASSPORT
pob
string/null
出生地,按护照可见内容返回;如未显示可返回 null
DILI
PASSPORT
issDate
string
签发日期,格式为 YYYY-MM-DD
2021-05-01
PASSPORT
expiryDate
string
有效期截止日期,格式为 YYYY-MM-DD
2031-05-01
PASSPORT
issAuthority
string/null
签发机关;如未显示可返回 null
MINISTRY OF JUSTICE
PASSPORT
line1
string
MRZ 第一行,通常以 P< 开头
P<TLSGUTERRES<<JOSE<<<<<<<<<<<<<<<<
PASSPORT
line2
string
MRZ 第二行,包含护照号、国籍、出生日期、有效期等信息
P1234567<TLS9006151M3105012<<<<<<<<
VOTER_CARD
cardType
string
证件类型,固定返回 VOTER_CARD
VOTER_CARD
VOTER_CARD
cardNo
string
选民卡号码,通常对应 Nú Cartão、No. Cartão、Nú. Kartaun 等字段
123456
VOTER_CARD
regNo
string
登记号或文件编号,通常对应 Nú De Inscrição、No. Doc、Nú. Dok 等字段
987654321
VOTER_CARD
name
string
持证人姓名,通常对应 Nome / Naran
JOAO DA COSTA
VOTER_CARD
dob
string
出生日期,格式为 YYYY-MM-DD
1995-08-10
VOTER_CARD
pob
string
出生地,通常对应 Naturalidade / Moris Fatin
BAUCAU
VOTER_CARD
municipality
string
市/区,通常对应 Município
DILI
VOTER_CARD
post
string
行政区,通常对应 Posto Adm.
DOM ALEIXO
VOTER_CARD
suco
string
Suku/Suco,村镇或基层区域名称
COMORO
VOTER_CARD
aldeia
string
Aldeia,基层居住区域名称
30 DE AGOSTO
# 尼日利亚多卡证 builtin-cimngo8Kfy06XJ6Wk8
卡证类型
字段名
类型
中文说明
示例
ID_CARD
cardType
string
证件类型枚举值
ID_CARD
ID_CARD
no
string
身份证号码,11 位以上数字,可包含空格
12345678901
ID_CARD
surame
string
姓氏 / 家族名
ADELEYE
ID_CARD
givenName
string
名 / 主要名
JOHN
ID_CARD
middleName
string
中间名,按证件显示,不可推断
MICHAEL
ID_CARD
dob
string
出生日期,格式 YYYY-MM-DD
1990-05-12
ID_CARD
issDate
string
证件签发日期,格式 YYYY-MM-DD
2015-10-08
ID_CARD
expiryDate
string
证件有效期,格式 YYYY-MM 或 YYYY-MM
2029-05
PASSPORT
cardType
string
证件类型枚举值
PASSPORT
PASSPORT
country
string
ISO 3166-1 alpha-3 国家代码
NGA
PASSPORT
Type
string
护照类型,如 P/D
P
PASSPORT
no
string
护照号码
A1234567
PASSPORT
+nameLocal
object/null
本地语言姓名结构
{ "full":"...", "surname":"...", "givenName":"..."}
PASSPORT
+nameLocal.full
string
本地语言完整姓名
አልሃምዱ ዲነካ ሬዳ
PASSPORT
+nameLocal.surname
string
本地语言姓氏 / 家族名
ዲነካ
PASSPORT
+nameLocal.givenName
string
本地语言名 / 给定名
አልሃምዱ
PASSPORT
+nameLocal.middleName
string
本地语言中间名(如果有)
ሬዳ
PASSPORT
+nameLatin
object
拉丁字母姓名结构
{ "full":"...", "surname":"...", "givenName":"..."}
PASSPORT
+nameLatin.full
string
拉丁字母完整姓名
ALHAMDU DINEKA REDA
PASSPORT
+nameLatin.surname
string
拉丁字母姓氏 / 家族名
DINEKA
PASSPORT
+nameLatin.givenName
string
拉丁字母名 / 给定名
ALHAMDU
PASSPORT
+nameLatin.middleName
string
拉丁字母中间名(如果有)
REDA
PASSPORT
nationality
string
国籍
NIGERIA
PASSPORT
dob
string
出生日期,格式 YYYY-MM-DD
1990-05-12
PASSPORT
gender
string
性别,M/F
M
PASSPORT
pob
string/null
出生地
LAGOS
PASSPORT
issPlace
string/null
签发地
null
PASSPORT
issDate
string
签发日期,YYYY-MM-DD
2015-10-08
PASSPORT
expiryDate
string
有效期,YYYY-MM-DD
2025-10-08
PASSPORT
issAuthority
string/null
签发机关
MINISTRY OF FOREIGN AFFAIRS
PASSPORT
MRZ
object
机器可读区信息
{ "line1":"...", "line2":"..." }
PASSPORT
+MRZ.line1
string
MRZ 第一行,通常以 P< 开头
P<NLSNAME<<GIVEN<<<<<<<<<<<<
PASSPORT
+MRZ.line2
string
MRZ 第二行,包含护照号、国籍、出生日期、有效期等信息
P1234567<NGA9006151M2510082<<<<<<<<<<
DRIVING_LICENSE
cardType
string
证件类型枚举值
DRIVING_LICENSE
DRIVING_LICENSE
no
string
驾驶证号码
03029/DNTT/C/IV/09
DRIVING_LICENSE
class
string
驾驶证类别
C
DRIVING_LICENSE
name
string
持证人姓名
JOHN MICHAEL ADELEYE
DRIVING_LICENSE
gender
string
性别,M/F
M
DRIVING_LICENSE
address
string/null
居住地址
null
DRIVING_LICENSE
dob
string
出生日期,YYYY-MM-DD
1990-05-12
DRIVING_LICENSE
issDate
string
签发日期,YYYY-MM-DD
2015-10-08
DRIVING_LICENSE
expiryDate
string
有效期,YYYY-MM-DD
2025-10-08
VOTER_CARD
cardType
string
证件类型枚举值
VOTER_CARD
VOTER_CARD
vin
string
选民编号(Voter Identification Number)
123456
VOTER_CARD
code
string
投票站编号
987
VOTER_CARD
delim
string
包含州/地方政府/选区的字符串
LAGOS IKEJA WARD1
VOTER_CARD
name
string
持证人姓名
JOHN MICHAEL ADELEYE
VOTER_CARD
gender
string
性别,M/F
M
VOTER_CARD
dob
string
出生日期,YYYY-MM-DD
1990-05-12
VOTER_CARD
occupa
string
职业
Teacher
VOTER_CARD
address
string/null
居住地址
null
# 巴西多卡证 builtin-VaJK7W9EV8wIOcV2pe
支持识别巴西常见证件/材料,返回cardType,包括:
ID:巴西身份证(RG / CIN)
DriverLicense:巴西驾驶证(CNH / CNH-e)
Passport:巴西护照
CPFCard:巴西 CPF 卡
VehicleRegistration:巴西车辆登记及许可证明(CRLV / CRLV-e)
CCMEI:巴西个体微型企业条件证明(CCMEI)
Vehicle:车辆照片,用于识别目标车辆车牌号
卡证类型/cardType
字段名
类型
中文说明
示例
ID
name
string
持证人姓名,通常对应 NOME、NOME / NAME
BERNARDO TZ
ID
socialName
string
社会姓名,仅当证件存在 NOME SOCIAL / SOCIAL NAME 字段时返回
MARIA SILVA
ID
no
string
身份证号码(RG号码),通常对应 REGISTRO GERAL、RG、Nº RG
4019865-7
ID
cpf
string
CPF个人税号,通常对应 CPF、Número CPF、CPF / Personal Number
131.478.554-06
ID
dob
string
出生日期,格式为 YYYY-MM-DD,通常对应 DATA DE NASCIMENTO、DATE OF BIRTH
1985-05-15
ID
gender
string
性别,可选值 M、F
M
ID
nationality
string
国籍,通常对应 NACIONALIDADE、NATIONALITY
BRASILEIRO
ID
pob
string
出生地,通常对应 NATURALIDADE、PLACE OF BIRTH
SAO PAULO - SP
ID
fatherName
string
父亲姓名,通常取 FILIAÇÃO / FILIATION 下第一行
JOSE DA SILVA
ID
motherName
string
母亲姓名,通常取 FILIAÇÃO / FILIATION 下第二行
MARIA DOS SANTOS
ID
issDate
string
签发日期,格式为 YYYY-MM-DD,通常对应 DATA DE EXPEDIÇÃO、DATA DE EMISSÃO
2022-02-19
ID
issuer
string
签发机构,通常对应 ÓRGÃO EXPEDIDOR、CARD ISSUER
SSP-SP
ID
poi
string
签发地点,通常对应 LOCAL DE EXPEDIÇÃO、LOCAL DE EMISSÃO、PLACE OF ISSUE
SAO PAULO
ID
expiryDate
string
有效期;日期转换为 YYYY-MM-DD,非日期内容保持原文
INDETERMINADA
DriverLicense
name
string
持证人姓名,通常对应 NOME、NOME E SOBRENOME
LUCIANO REIS DE OLIVEIRA
DriverLicense
licenseNo
string
驾驶证注册号码,通常对应 Nº REGISTRO、5 Nº REGISTRO
04054230998
DriverLicense
cpf
string
CPF号码,通常对应 CPF、4e CPF
034.343.099-18
DriverLicense
idNo
string
身份证号码(RG),通常对应组合字段 DOC. IDENTIDADE / ÓRG. EMISSOR / UF 中第一部分
246969374
DriverLicense
idIssuer
string
身份证签发机构,通常对应 DOC. IDENTIDADE / ÓRG. EMISSOR / UF 中第二部分
SSP
DriverLicense
idState
string
身份证签发州,通常对应 DOC. IDENTIDADE / ÓRG. EMISSOR / UF 中第三部分
SP
DriverLicense
dob
string
出生日期,通常对应 DATA LOCAL E UF DE NASCIMENTO,格式 YYYY-MM-DD
1955-08-14
DriverLicense
pob
string
出生地点,通常位于 DATA LOCAL E UF DE NASCIMENTO 日期之后
MATUTINA/MG
DriverLicense
fatherName
string
父亲姓名,通常取 FILIAÇÃO 下第一行
JOSE FELICIO DO AMARAL
DriverLicense
motherName
string
母亲姓名,通常取 FILIAÇÃO 下第二行
IZOLINA MARIA DE JESUS
DriverLicense
category
string
当前驾驶类别,通常对应 CAT. HAB.
D
DriverLicense
nationality
string
国籍,通常对应 NACIONALIDADE
BRASILEIRO
DriverLicense
categoryDetails
array
各驾驶类别及对应有效期,仅返回有明确有效期的类别;相同有效期的类别合并
[{"category":["B","C"],"expiryDate":"2029-09-06"}]
DriverLicense
licenseDate
string
首次取得驾驶资格日期,通常对应 1ª HABILITAÇÃO
2001-01-19
DriverLicense
issDate
string
当前驾驶证签发日期,通常对应 4a DATA EMISSÃO、DATA EMISSÃO
2022-11-07
DriverLicense
expiryDate
string
驾驶证有效期,通常对应 4b VALIDADE
2032-07-16
DriverLicense
poi
string
签发地点,通常对应底部 LOCAL 字段
OSVALDO CRUZ SP
DriverLicense
observations
string
备注或限制信息,通常对应 OBSERVAÇÕES
EAR
DriverLicense
acc
boolean
是否具备 ACC(Autorização para Conduzir Ciclomotor,轻便摩托车驾驶许可)。明确勾选/授予时为 true;明确未授予、为空或划除时为 false
true
Passport
country
string
签发国家 ISO 3166-1 alpha-3 国家代码
BRA
Passport
type
string
护照类型代码
P
Passport
no
string
护照号码,通常对应 PASSAPORTE Nº、PASSPORT No.
AA000681
Passport
surname
string
姓氏/家族名,通常对应 SOBRENOME、SURNAME
COSTA
Passport
givenName
string
名字,通常对应 NOME、GIVEN NAME
CARLOS
Passport
nationality
string
国籍,通常对应 NACIONALIDADE、NATIONALITY
BRASILEIRO(A)
Passport
dob
string
出生日期,格式为 YYYY-MM-DD
2001-03-16
Passport
gender
string
性别,可选值 M、F
M
Passport
pob
string
出生地,通常对应 NATURALIDADE、PLACE OF BIRTH
BRASILIA/DF
Passport
idNo
string
个人身份号码,通常对应 IDENTIDADE Nº / PERSONAL No.,保持证件原始格式
12.345.678-9
Passport
fatherName
string
父亲姓名,通常取 FILIAÇÃO / FILIATION 第一行
MARCOS JOSE DOS SANTOS
Passport
motherName
string
母亲姓名,通常取 FILIAÇÃO / FILIATION 第二行
AMANDA FARIAS DOS SANTOS
Passport
issDate
string
签发日期,格式为 YYYY-MM-DD
2012-07-06
Passport
expiryDate
string
有效期截止日期,格式为 YYYY-MM-DD
2022-07-06
Passport
issAuthority
string
签发机构,通常对应 AUTORIDADE / AUTHORITY
SR/PF/RJ
Passport
line1
string
MRZ第一行,通常以 P< 开头
P<BRA...
Passport
line2
string
MRZ第二行
AA000681BRA...
CPFCard
no
string
CPF号码,通常对应 Número de Inscrição、CPF;保持证件显示格式
123.456.789-09
CPFCard
name
string
持证人姓名,通常对应 Nome、Nome da Pessoa
JOAO SILVA
CPFCard
dob
string
出生日期,通常对应 Nascimento,格式为 YYYY-MM-DD
1990-05-12
CPFCard
issDate
string
签发日期,通常对应 Emissão;格式为 YYYY-MM
2020-08
VehicleRegistration
renavam
string
巴西全国机动车登记号,通常对应 CÓDIGO RENAVAM / RENAVAM,保留前导 0
01091602368
VehicleRegistration
plate
string
当前车辆车牌号,通常对应 PLACA;支持旧版及 Mercosur 车牌格式
ABC1D23
VehicleRegistration
exerciseYear
string
当前车辆年审/许可所属年份,通常对应 EXERCÍCIO,不要与制造年份、车型年份混淆
2026
VehicleRegistration
fuelType
string
燃油/动力类型,通常对应 COMBUSTÍVEL,保持证件原文
ALCOOL/GASOLINA
VehicleRegistration
category
string
车辆登记使用类别,通常对应 CATEGORIA
PARTICULAR
VehicleRegistration
capacity
string
车辆载重/容量信息,通常对应 CAPACIDADE / CAP
0.45
VehicleRegistration
ownerName
string
登记车主姓名,通常对应车主区域的 NOME
JOAO DA SILVA
VehicleRegistration
cpf
string
登记车主 CPF;若证件 CPF/CNPJ 实际为 CNPJ,则该字段不返回 CNPJ
297.365.848-95
CCMEI
cpf
string
个体微型企业经营者 CPF,通常对应 CPF;不得与 CNPJ、NIRE 等企业登记编号混淆
123.456.789-00
CCMEI
registrationStatus
string
当前登记状态,通常对应 Situação Cadastral Vigente,保持证件原文
ATIVO
Vehicle
plate
string
车辆照片中目标车辆的车牌号码;支持巴西旧版车牌及 Mercosur 车牌格式
ABC1D23
# 越南身份证 builtin-86og0wZ7HLhSXlYG7p
字段名
类型
中文说明
示例
idNo
string
越南身份证号码/公民身份号码
001096840920
name
string
持证人姓名,按证件显示内容返回
NÔNG VAN HIEU
gender
string
持证人性别,M=男,F=女
M
bDate
string
持证人出生日期,格式为 YYYY-MM-DD
1996-05-16
nationality
string
持证人国籍,按证件显示内容返回
Việt Nam
origin
string
原籍/出生地/籍贯信息(Quê quán),按证件显示内容返回
Chi Dông, Mê Linh, Hà Noi
res
string
常住地址/居住地址(Nơi thường trú),按证件显示内容返回
To 2, Chi Dong, Me Linh, Hà Noi
expiryDate
string/null
证件有效期截止日期,格式为 YYYY-MM-DD;无有效期时返回 null
2028-05-16
issueDate
string/null
证件签发日期,格式为 YYYY-MM-DD
2021-06-21
issuer
string/null
证件签发机关
CUC TRUONG CUC CANH SAT QUAN LY HANH CHINH VE TRAT TU XA HOI
isID
boolean
是否为越南身份证:true=是,false=否。支持越南不同版本身份证,包括 Căn Cước Công Dân(CCCD,公民身份证)及 Chứng Minh Nhân Dân / Giấy Chứng Minh Nhân Dân(CMND,旧版人民身份证);护照、驾驶证及其他非身份证件返回 false。
true
qrData
object/null
身份证二维码解析结果;二维码不存在或无法解析时返回 null
-
+idNo
string
二维码中解析出的身份证号码
001096840920
+oldIdNo
string/null
二维码中解析出的旧身份证号码;不存在时返回 null
012345678
+name
string
二维码中解析出的姓名
NÔNG VAN HIEU
+bDate
string
二维码中解析出的出生日期,格式为 YYYY-MM-DD
1996-05-16
+gender
string
二维码中解析出的性别(原始值)
Nam / Nữ
+res
string
二维码中解析出的居住地址
To 2, Chi Dong, Me Linh, Hà Noi
+issueDate
string
二维码中解析出的签发日期,格式为 YYYY-MM-DD
2021-06-21
# 泰国身份证 builtin-i88oDw1H2dbkpAXzJ3
字段名
类型
中文说明
示例
name
string
持证人英文完整姓名,由英文名与英文姓组合返回
Mr. Napat Thaikiaue
firstName
string
持证人英文名,包含卡面印刷的敬语/称谓,如 Mr.、Mrs.、Miss.
Mr. Napat
lastName
string
持证人英文姓氏
Thaikiaue
thaiName
string
持证人泰文完整姓名,按卡面原文返回
นาย ณภัทร ไทยเกื้อ
thaiFirstName
string
持证人泰文名,包含卡面印刷的泰文敬语/称谓
นาย ณภัทร
thaiLastName
string
持证人泰文姓氏
ไทยเกื้อ
idNo
string
泰国国民身份证号码,13位数字,返回时去除数字间空格
1100200280560
laserId
string
身份证背面的 Laser ID(Laser Code),保留连字符;未提供背面或无法识别时返回空
AB1-2345678-90
bDate
string
出生日期,统一返回 YYYY-MM-DD 格式
1992-11-23
gender
string
性别,标准化返回 M 或 F
M
address
string
地址,按卡面泰文地址完整返回
96 ถ.รังสิต-ปทุมธานี 27 ต.ประชาธิปัตย์ อ.ธัญบุรี จ.ปทุมธานี
issueDate
string
身份证签发日期,统一返回 YYYY-MM-DD 格式
2020-11-22
expiryDate
string
身份证有效期,统一返回 YYYY-MM-DD 格式;永久有效返回 LIFELONG
2024-06-26 / LIFELONG
# 柬埔寨身份证 builtin-IPC3Peq8NRXRxr4ZbE
字段名
类型
中文说明
示例
no
string
柬埔寨身份证号码
190457306
fullNameLatin
string
持证人拉丁字母姓名
VANN VIREAK
fullNameLocal
string
持证人本地语言姓名
វ៉ាន់ វីរៈ
gender
string
持证人性别;可选值 M、F
M
dob
string
持证人出生日期,格式为 YYYY-MM-DD
1967-11-13
height
string
持证人身高,按证件显示内容返回
១៦១ ស.ម
issDate
string
证件签发日期,格式为 YYYY-MM-DD
2015-10-08
expiryDate
string
证件有效期截止日期,格式为 YYYY-MM-DD
2035-07-07
nationality
string
持证人国籍或国家代码
KHM
pob
string
持证人出生地,按证件显示内容返回
ឃុំអន្លង់វិល ស្រុកសង្កែ បាត់ដំបង
address
string
持证人住址,按证件显示内容返回
ភូមិត្រពេច ស្រុកថ្មពួក បន្ទាយមានជ័យ
identifyingMarks
string
持证人身体识别特征或显著标记
ប្រជ្រុយចំ ០.៥សម មុខលើគល់ភ្នែកស្តាំ
mrzLine1
string
MRZ 第一行内容
IDKHM1904573061<<<<<<<<<<<<<<<<
mrzLine2
string
MRZ 第二行内容
6711137M3507072KHM<<<<<<<<<<<<4
mrzLine3
string
MRZ 第三行内容
VANN<<VIREAK<<<<<<<<<<<<<<<<<<<
# 孟加拉身份证 builtin-eK6p0vOB1AZmpGhLi9
字段名
类型
中文说明
示例
idNo
string
孟加拉身份证号码 ID No.
8704637043
name
string
持证人英文姓名
MD. SHIPON MIA
localName
string
持证人本地语言姓名
মোঃ শিপন মিয়া
fatherName
string
持证人父亲姓名,通常为本地语言
মোঃ সাজু মিয়া
motherName
string
持证人母亲姓名,通常为本地语言
মোছাঃ শিল্পী বেগম
dob
string
持证人出生日期,格式为 YYYY-MM-DD
1998-09-25
gender
string
持证人性别;F/M,如证件未显示或无法识别,为空字符串
F
blood
string
持证人血型;如证件未显示或无法识别,为空字符串
A+
address
string
持证人地址;如证件未显示或无法识别,为空字符串
pob
string
持证人出生地;如证件未显示或无法识别,为空字符串
JHALOKATI
issDate
string
证件签发日期,格式为 YYYY-MM-DD;如证件未显示或无法识别,可为空字符串
2026-11-03
expiryDate
string
证件有效期截止日期,格式为 YYYY-MM-DD;如证件未显示或无法识别,为空字符串
2036-11-03
# 马来西亚身份证 builtin-5DgJZFnVtvqKdKy2rW
字段名
类型
中文说明
示例
no
string
身份证号码(MyKad 编号)
460619-12-5087
dob
string
出生日期(YYYY-MM-DD)
1946-06-19
name
string
姓名
ABD RAUF BIN HAMSAH
gender
string
性别;M 表示男性,F 表示女性
M
address
string
地址
P O BOX 42, 89007 KENINGAU, SABAH
nationality
string
国籍/公民身份
WARGANEGARA
religion
string
宗教
ISLAM
issuer
string
签发机关
KETUA PENGARAH PENDAFTARAN NEGARA
# 马来西亚6类身份证 builtin-dQbsIBC449C50mxoPj
支持识别马来西亚常见身份类证件。当前支持的 cardType 包括:MYKAD、DRIVER_LICENSE、MYTENTERA、PASSPORT、MYPR、MYKAS;无法确定证件类型时返回 OTHER。
卡证类型
字段
类型
正面/反面
含义
输出示例
全部
cardType
string
通用
卡证类型:MYKAD=马来西亚公民身份证,DRIVER_LICENSE=驾驶证,MYTENTERA=军人身份证,PASSPORT=护照,MYPR=永久居民身份证,MYKAS=临时居民身份证,OTHER=其他或无法确定
MYKAD
MYKAD
no
string
正面
身份证号码,保留卡面连字符和前导零
460619-12-5087
MYKAD
name
string
正面
持证人完整姓名,多行姓名使用一个空格连接
ABD RAUF BIN HAMSAH
MYKAD
gender
string
正面
性别:M=男,F=女,X=其他
M
MYKAD
religion
string
正面
宗教,按卡面原文返回
ISLAM
MYKAD
citizenshipStatus
string
正面
公民身份状态,按卡面原文返回
WARGANEGARA
MYKAD
address
string
正面
完整居住地址,多行地址按顺序使用一个空格连接
KAMPUNG MASJID P O BOX 42 89007 KENINGAU SABAH
MYKAD
registrationNo
string
反面
卡片登记号码,保留连字符和前导零
1759624-36-1684-49
MYKAD
passportNo
string
反面
反面括号内的护照号码,结果不包含外层括号
A3456987
DRIVER_LICENSE
name
string
正面
持证人完整姓名
MOHD NAZRI BIN AHMAD
DRIVER_LICENSE
nationality
string
正面
国籍,按卡面原文返回
MALAYSIA
DRIVER_LICENSE
no
string
正面
身份证件号码,对应 No. Pengenalan / Identity No.
820222075547
DRIVER_LICENSE
class
string
正面
准驾车型或驾驶证类别,多个类别使用空格连接
B2 D
DRIVER_LICENSE
issDate
string
正面
有效期起始日期,格式为 YYYY-MM-DD
2013-08-18
DRIVER_LICENSE
expiryDate
string
正面
有效期结束日期,格式为 YYYY-MM-DD
2015-02-22
DRIVER_LICENSE
address
string
正面
完整地址,多行地址按顺序使用一个空格连接
39 TMN SRI PEKULA 2 TIKAM BATU 08000 SUNGAI PETANI KEDAH
MYTENTERA
no
string
正面
军人身份证号码,保留卡面连字符和前导零
910613-01-6877
MYTENTERA
serviceNo
string
正面
军人服役号或人员编号,通常位于芯片附近
1173748
MYTENTERA
name
string
正面
持证人完整姓名,多行姓名使用一个空格连接
MOHD NAZRUL SYAMIR AKMAL BIN MOHD NOR
MYTENTERA
address
string
正面
卡面完整地址块,可能为居住、联系、驻地或军队单位地址
MARKAS TENTERA DARAT CAWANGAN SUMBER MANUSIA KEMENTAH JALAN PADANG TEMBAK 50634 KUALA LUMPUR W. PERSEKUTUAN(KL)
MYTENTERA
militaryBranch
string
正面
军种,按卡面原文返回
DARAT
MYTENTERA
religion
string
正面
宗教,按卡面原文返回
ISLAM
MYTENTERA
rankCategory
string
正面
军事人员或军衔类别,按卡面原文返回
LLP
MYTENTERA
gender
string
正面
性别:M=男,F=女,X=其他
M
PASSPORT
country
string
正面(资料页)
三位国家代码,对应 Kod Negara / Country Code
MYS
PASSPORT
type
string
正面(资料页)
护照类型,对应 Jenis / Type
P
PASSPORT
no
string
正面(资料页)
护照号码,对应 No. Pasport / Passport No.
A55114611
PASSPORT
name
string
正面(资料页)
持证人完整姓名,对应 Nama / Name,不拆分姓和名
MUHAMMAD SHAUKI BIN SAAD
PASSPORT
nationality
string
正面(资料页)
国籍,对应 Warganegara / Nationality,按原文返回
MALAYSIA
PASSPORT
dob
string
正面(资料页)
出生日期,格式为 YYYY-MM-DD
1999-11-19
PASSPORT
idNo
string
正面(资料页)
马来西亚身份证件号码,对应 No. Pengenalan / Identity No.
991119026233
PASSPORT
gender
string
正面(资料页)
性别:M=男,F=女
M
PASSPORT
pob
string
正面(资料页)
出生地,对应 Tempat Lahir / Place of Birth
KEDAH
PASSPORT
height
string
正面(资料页)
身高,保留数值和单位
162 cm
PASSPORT
issDate
string
正面(资料页)
签发日期,格式为 YYYY-MM-DD
2022-03-09
PASSPORT
expiryDate
string
正面(资料页)
到期日期,格式为 YYYY-MM-DD
2027-03-09
PASSPORT
issOffice
string
正面(资料页)
签发办公室,对应 Pejabat Pengeluar / Issuing Office
UTC KEDAH
PASSPORT
line1
string
正面(资料页)
机读区第一行,保留全部字母和 < 字符
P<MYSMUHAMMAD<SHAUKI<BIN<SAAD<<<<<<<<<<<<
PASSPORT
line2
string
正面(资料页)
机读区第二行,保留全部字母、数字和 < 字符
A551146110MYS9911190M2703095991119026233<<<82
MYPR
no
string
正面
永久居民身份证号码,保留卡面连字符和前导零
990007-90-7007
MYPR
name
string
正面
持证人完整姓名,多行姓名使用一个空格连接
WANG CHONG CHONG
MYPR
gender
string
正面
性别:M=男,F=女,X=其他
M
MYPR
religion
string
正面
宗教,按卡面原文返回
ISLAM
MYPR
nationalityCode
string
正面
原国籍或国家三字代码,按卡面原文返回
GRD
MYPR
address
string
正面
完整地址,多行地址按顺序使用一个空格连接
A-06-03 ARIA RESIDENCE 213 JALAN TUN RAZAK 50450 KUALA LUMPUR
MYPR
nationality
string
反面
原国籍或原籍国家,对应 NEGARA ASAL
GRENADA
MYPR
registrationNo
string
反面
卡片登记号码,保留连字符、前导零及末尾后缀
990007-90-7007-01
MYPR
entryPermitNo
string
反面
入境准证号码,结果不包含 PM: 前缀
A0000019007
MYKAS
no
string
正面
临时居民身份证号码,保留卡面连字符和前导零
930501-01-6897
MYKAS
name
string
正面
持证人完整姓名,多行姓名使用一个空格连接
SADDAM HUSSEIN
MYKAS
gender
string
正面
性别:M=男,F=女,X=其他
M
MYKAS
religion
string
正面
宗教,按卡面原文返回
ISLAM
MYKAS
citizenshipStatus
string
正面
公民身份状态,按卡面原文返回
BUKAN WARGANEGARA
MYKAS
address
string
正面
完整地址,多行地址按顺序使用一个空格连接
NO 145 LORONG 10 TAMAN JUJUR SIKAMAT 70400 SEREMBAN NEGERI SEMBILAN
MYKAS
expiryDate
string
正面
卡片到期日期,对应 Tarikh Luput,格式为 YYYY-MM-DD
2019-03-10
# 文莱身份证 builtin-zZPeRQYVJ6JUQR6Ce4
字段名
类型
中文说明
示例
type
string
居留/公民身份;CITIZEN 表示公民,PERMANENT 表示永久居民,TEMPORARY 表示临时居民
CITIZEN
no
string
身份证号码(个人身份证号)
65-453556
name
string
姓名
SHUFTI PRO
dob
string
出生日期(YYYY-MM-DD)
1990-06-09
pob
string
出生地或出生国家
BRUNEI DARUSSALAM
gender
string
性别;M 表示男性,F 表示女性
M
address
string
居住地址
09-XXX
# 印度身份证 builtin-2t7zclgvWLt4OzmuRh
字段名
类型
中文说明
示例
no
string
身份证号码(Aadhaar Number)
342506531151
name
string
姓名
Sid malhorta
birth
string
出生日期(YYYY-MM-DD)
1980-03-16
gender
string
性别;M 表示男性,F 表示女性
F
# 南非身份证 builtin-KMw0wDDdzSTs62jD6v
字段名
类型
中文说明
示例
surname
string
持证人姓氏 / 家族名
IMMELMAN
names
string
持证人名 / 给定名
WAYNE LEE
gender
string
持证人性别,可选值 M 或 F
M
nationality
string
持证人国籍,按证件上显示
RSA
no
string
南非身份证号码,通常为 13 位数字字符串
8510315120089
dob
string
出生日期,格式 YYYY-MM-DD
1985-10-31
pob
string
出生地 / Country of Birth,按证件显示
RSA
status
string
公民身份或居留状态
CITIZEN
issDate
string
证件签发日期,格式为 YYYY-MM-DD
2015-10-08
# 埃塞俄比亚身份证 builtin-inpf3JKw4iBGRg6o1K
字段名
类型
中文说明
示例
nameLocal
string
持证人本地语言姓名,通常为阿姆哈拉语姓名
አልሃምዱ ዲነካ ሬዳ
nameLatin
string
持证人拉丁字母姓名,按证件可见内容返回
Alhamdu Dineka Reda
gender
string
持证人性别;可选值 M、F
M
dobLocal
string
持证人出生日期,埃塞俄比亚本地历法日期,格式为 YYYY-MM-DD
1996-01-01
dob
string
持证人出生日期,国际通用公历日期,格式为 YYYY-MM-DD
2003-09-12
nationalityLocal
string
持证人本地语言国籍或公民身份信息
ኢትዮጵያዊ
nationality
string
持证人英文国籍或公民身份信息
Ethiopian
fan
string
FAN 编号,按证件显示的可见号码返回;不包含 FAN 标签,未显示时可为空字符串
4195302617209485
fin
string
FIN 编号,按证件显示的可见号码返回;不包含 FIN 标签,未显示时可为空字符串
581260930236
fcn
string
FCN 编号,按证件显示的可见号码返回;不包含 FCN 标签,未显示时可为空字符串
2132836096158706
issDateLocal
string
证件签发日期,埃塞俄比亚本地历法日期,格式为 YYYY-MM-DD
2017-07-15
issDate
string
证件签发日期,国际通用公历日期,格式为 YYYY-MM-DD
2025-03-24
expiryDateLocal
string
证件有效期截止日期,埃塞俄比亚本地历法日期,格式为 YYYY-MM-DD
2025-08-13
expiryDate
string
证件有效期截止日期,国际通用公历日期,格式为 YYYY-MM-DD
2033-04-21
printDate
string
证件打印日期,国际通用公历日期,格式为 YYYY-MM-DD
2024-06-13
phone
string
持证人联系电话,通常位于证件背面,按可见内容返回
0912662007
addressLocal
string
持证人本地语言地址,通常位于证件背面;仅提取阿姆哈拉语地址行,多行地址用英文逗号合并
ኦሮሚያ, ቢሾፍቱ, ኦዳ ናቤ
address
string
持证人英文或拉丁字符地址,通常位于证件背面;仅提取英文/拉丁字符地址行,多行地址用英文逗号合并
Oromia, Bishoftu City Administration - Dukam, Oda Nabe
# 肯尼亚身份证 builtin-Kc19djI2nepOIrFrjy
字段名
类型
中文说明
示例
serialNo
string
证件序列号(SERIAL NUMBER),通常位于卡片左侧或顶部
A1234567
no
string
身份证号 / HUDUMA / MAISHA 编号
12345678
name
string
持证人全名(FULL NAME / FULL NAMES)
JOHN MWANGI KAMAU
dob
string
出生日期,统一格式 YYYY-MM-DD
1990-08-30
gender
string
性别,M=男 / F=女
M
nationality
string
国籍
KEN
pob
string
出生地(PLACE/DISTRICT OF BIRTH)
NAIROBI
issPlace
string
签发地点(PLACE OF ISSUE)
NAIROBI
issDate
string
签发日期,YYYY-MM-DD
2020-12-04
expiryDate
string
有效期/到期日期,YYYY-MM-DD
2033-12-04
# 阿根廷身份证 builtin-RpAJLFfches2ML9fH9
图片质量与人脸检测相关能力默认不返回,需要联系商务人员开启权限。
# 哥伦比亚身份证 builtin-rZugtolMwF7J6nkux6
字段名
类型
中文说明
示例
ID
object
卡面视觉区域识别结果
-
+no
string
国家身份证号码(NUIP)
1.000.000.000
+sur
string
姓氏(Apellidos)
CASAS RUBIANO
+given
string
名字(Nombres)
DANIELA
+dob
string
出生日期
2000-12-11
+sex
string
性别
M / F
+pob
string
出生地点(Lugar de nacimiento)
CARTAGENA (BOLIVAR)
+poi
string
签发地点(Lugar de expedición)
CARTAGENA
+iss
string
签发日期
2019-01-16
+exp
string
有效期
2033-02-26
MRZ
object
机器可读区识别结果
-
+docno
string
MRZ 第一行中的证件编号
000000012
+dob
string
MRZ 出生日期
1988-08-21
+sex
string
MRZ 性别
M / F
+exp
string
MRZ 有效期
2031-01-30
+fname
string
MRZ 解析后的完整姓名
CASAS RUBIANO DANIELA
# 秘鲁身份证 builtin-TrAXBLVnyyKJQdar1e
字段名
类型
中文说明
示例
front
object
身份证正面识别结果
-
+dni
string
身份证号码(DNI)
47973966
+surname1
string
第一姓(父姓)
SANCHEZ
+surname2
string
第二姓(母姓)
HUAPAYA
+names
string
名字,可包含多个名字
ESTEPHANI ELIZABETH
+birthDate
string
出生日期
1993-08-27
+birthUbigeo
string
出生地 UBIGEO 行政区代码
140133
+sex
string
性别,F=女,M=男
F
+marital
string
婚姻状态
S
+regDate
string
登记日期
2010-11-10
+issueDate
string
证件签发日期
2023-02-23
+expDate
string
证件有效期
2031-02-23
back
object
身份证背面识别结果
-
+dept
string
省级行政区(Department)
LIMA
+prov
string
省(Province)
LIMA
+dist
string
区/县(District)
SANTIAGO DE SURCO
+addr
string
居住地址
MZ.C LT.18 ASOC. DE VIV SAN JOSE
+level
string
登记级别代码
140130
+organ
string
器官捐献意愿
SI / NO
+voteGrp
string
投票组代码
257530
# 厄瓜多尔身份证 builtin-EJdRAGeuyPLAG6qv8I
图片质量与人脸检测相关能力默认不返回,需要联系商务人员开启权限。
字段名
类型
所在卡面
中文说明
示例
name
string
正面
持证人完整姓名(姓氏+名字)
VIZUETE VIZUETE ANGEL HERIBER
surname
string
正面
姓氏
VIZUETE VIZUETE
givenName
string
正面
名字
ANGEL HERIBER
no
string
正面
证件号码(Document Number)
091787689-8
nui
string
正面
唯一身份识别号码(NUI)
1719142905
nationality
string
正面
国籍
ECUATORIANA
gender
string
正面
性别
M / F
dob
string
正面
出生日期(YYYY-MM-DD)
1993-01-19
pob
string
正面
出生地点
CHIMBORAZO RIOBAMBA
expiryDate
string
正面
证件有效期(YYYY-MM-DD)
2031-12-08
issueDate
string
反面
证件签发日期(YYYY-MM-DD)
2021-12-08
issuePlace
string
反面
证件签发地点
RIOBAMBA
father
string
反面
父亲姓名
VIZUETE VIDAL
mother
string
反面
母亲姓名
VIZUETE MARIA
spouse
string
反面
配偶或同居伴侣姓名
LARA RUIZ MARIA MAGDALENA
maritalStatus
string
反面
婚姻状况
CASADO
isCard
string
-
是否为厄瓜多尔身份证
true/false
mrz
object
MRZ
机器可读区(MRZ)识别结果
-
+no
string
MRZ
MRZ 证件号码
017836244
+nationality
string
MRZ
MRZ 国籍(三字母代码)
ECU
+dob
string
MRZ
MRZ 出生日期(YYYY-MM-DD)
1993-01-19
+gender
string
MRZ
MRZ 性别
M / F
+expiryDate
string
MRZ
MRZ 有效期(YYYY-MM-DD)
2031-12-08
+surname
string
MRZ
MRZ 姓氏
VIZUETE VIZUETE
+givenName
string
MRZ
MRZ 名字
ANGEL HERIBER
faces
array
正面/背面
卡证图片中检测到的人脸位置列表;支持多张人脸,未检测到人脸时返回 []
[{"width":0.15498,"top":0.59956,"left":0.12833,"height":0.24289}]
+width
float
正面/背面
人脸框宽度,占原图宽度的比例
0.15498
+top
float
正面/背面
人脸框左上角纵坐标,占原图高度的比例
0.59956
+left
float
正面/背面
人脸框左上角横坐标,占原图宽度的比例
0.12833
+height
float
正面/背面
人脸框高度,占原图高度的比例
0.24289
quality
string
正面/背面
图片质量总体辅助判定;1 表示关键视觉信息基本清晰可用,0 表示可能存在影响识别或使用的问题,建议人工复查
1
issues
array
正面/背面
图片质量问题列表;1 模糊低分辨率,2 反光,3 过暗,4 过亮,5 屏幕翻拍,6 卡证不完整/破损,7 卡证遮挡/涂抹;无问题返回 []
["6"]
# 6 异常说明
HTTP状态代码
错误信息
说明
400
BAD_ARGUMENTS:
某个参数解析出错(比如BAD_ARGUMENTS:app_id,传入不存在的app_id)
400
FILE_PARSE_FAILED:
文件下载阶段失败
400
FILE_EXTRACT_FAILED:
文件识别阶段失败
400
INVALID_INPUTS_PARAM:
自定义字段inputs格式不合法
400
FILE_TOO_LARGE
文件超过大小限制,建议9M以内
400
FILE_UNSUPPORTED_FORMAT
不支持的文件格式
400
TOO_MANY_FILES
入参中传入了多余实际支持的文件数量
400
MISSING_ARGUMENTS:
缺少某个必选参数
400
KEY_NOT_FOUND
encryption_type开启加密,但未配置加密公钥和解密私钥
403
AUTHENTICATION_ERROR
api_key和api_secret不匹配
403
AUTHORIZATION_ERROR:
api_key被停用、调用次数超限、没有调用此API的权限,或者没有以当前方式调用此API的权限。比如:"DENIED." : api_key无权限或被停用,"Limit reached." : 这个api_key对当前API的调用量达到上限。
403
CONCURRENCY_LIMIT_EXCEEDED
并发数超过限制
403
AUTHENTICATION_ERROR: NO_APP_PERMISSION
无app调用权限
404
API_NOT_FOUND
所调用的API接口地址不存在
500
INTERNAL_ERROR
服务器内部错误,当此类错误发生时请再次请求,如果持续出现此类错误,请及时联系 FaceID 客服或商务
# 7 计费逻辑说明
HTTP状态码status_code=200 且返回数据中pages不为空时计费/扣除试用次数。
# 8 响应示例
# 8.1 正确请求返回示例(通用护照识别)
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 {
"request_id": "a2c5e8b1-4f7d-4a9e-8c3b-6e1d5f8a2b3c",
"time_used": 932,
"pages": 1,
"result": {
"outputs": {
"text": {
"countryCode": "CHN",
"passportNumber": "E40898665",
"fullNameLocal": "张三",
"fullNameLatin": "ZHANG SAN",
"surname": "ZHANG",
"givenName": "SAN",
"middleName": null,
"nationality": "CHINESE",
"dateOfBirth": "2009-09-09",
"sex": "F",
"placeOfBirth": "河北",
"placeOfIssue": "河北",
"dateOfIssue": "2015-01-06",
"dateOfExpiry": "2020-01-05",
"issuingAuthority": "公安部出入境管理局",
"isPP": true
}
}
}
}
# 8.2 错误相应返回示例
1 2 3 4 5 {
"request_id": "d5f8b2e4-7c1a-4d3f-9b6e-2a4c8d3b5e6f",
"time_used": 150,
"error_message": "FILE_TOO_LARGE"
}