# 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
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住房公积金会员身份证,OTHER上述范围之外的其他卡证
正面或背面
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"]
全部
is_tampered
boolean
图片篡改检测结果;true 表示检测到疑似篡改区域,false 表示未检测到疑似篡改区域
正面或背面
true
全部
tampered_positions
string
疑似篡改区域的坐标信息,以 JSON 字符串形式返回;每组包含一个四边形区域的 4 个顶点坐标,格式为 [x1,y1,x2,y2,x3,y3,x4,y4];未检测到篡改区域时通常返回 "[]"
正面或背面
"[[442,371,581,371,581,464,442,464]]"
# 巴基斯坦多卡证识别 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;
123.456.789-00
CCMEI
registrationStatus
string
当前登记状态,通常对应 Situação Cadastral Vigente,保持证件原文
ATIVO
Vehicle
plate
string
车辆照片中目标车辆的车牌号码;支持巴西旧版车牌及 Mercosur 车牌格式
ABC1D23
# 加纳多证件识别 builtin-REIX6jKymco4s2Ckjv
当前支持以下 4 类加纳证件:
IDCard:加纳身份证(Ghana Card)
DriverLicense:加纳驾驶证或加纳国际驾驶许可证
Passport:加纳护照
VoterID:加纳选民证
'Other':其他
图片质量与人脸检测相关能力默认不返回,需要联系商务人员开启权限。
卡证类型
字段
类型
含义
输出示例
全部
cardType
string
卡证类型:IDCard、DriverLicense、Passport、VoterID、Other
IDCard
IDCard
idType
string
身份证持有人/卡片类型:CITIZEN=加纳公民(包括出生、登记或归化取得公民身份),NON_CITIZEN=非公民,REFUGEE=难民
CITIZEN
IDCard
no
string
Ghana Card Personal Identification Number;保留完整三字母前缀、数字主体和校验位
GHA-000000000-1
IDCard
surname
string
姓,对应 SURNAME / NOM
ARABA
IDCard
firstName
string
名或全部名字,对应 FIRST NAME(S) / PRÉNOM(S)
COCO
IDCard
previousNames
string
曾用名或婚前姓名,对应 PREVIOUS NAME(S) 等卡面标签
MARK
IDCard
dob
string
出生日期,格式为 YYYY-MM-DD
1986-06-13
IDCard
gender
string
性别,规范化为 M 或 F
F
IDCard
nationality
string
国籍,按卡面原文返回
GHANAIAN
IDCard
height
string
身高,仅返回数值,不带单位
1.85
IDCard
documentNo
string
Document Number,与 Ghana Card PIN 分开返回
AR1010101
IDCard
issPlace
string
签发地,对应 PLACE OF ISSUANCE / PLACE OF ISSUE
ACCRA
IDCard
issDate
string
签发日期,格式为 YYYY-MM-DD
2024-08-15
IDCard
expiryDate
string
到期日期,格式为 YYYY-MM-DD
2034-08-14
DriverLicense
no
string
驾驶证号码 LICENCE # / LICENCE NUMBER;国际驾驶许可证返回 IDP NUMBER。保留字母、数字、连字符和前导零
EMV-27091980-37883
DriverLicense
name
string
持证人姓名。普通驾驶证提取 NAME;国际驾驶许可证将姓与名字按“姓 + 空格 + 名字”组合
VORDZOGBE EMIL ETHELBERT
DriverLicense
dob
string
出生日期,格式为 YYYY-MM-DD
1980-09-27
DriverLicense
gender
string
性别,规范化为 M 或 F;卡面未印刷时返回空字符串
M
DriverLicense
nationality
string
国籍,按卡面原文返回
Ghanaian
DriverLicense
licenceClass
string
准驾车型/驾驶证类别;多个类别使用一个空格连接
B D
DriverLicense
issDate
string
签发日期,格式为 YYYY-MM-DD
2018-11-26
DriverLicense
expiryDate
string
到期日期,格式为 YYYY-MM-DD
2024-11-25
DriverLicense
refNo
string
REF # / REFERENCE NUMBER,与驾驶证号码分开返回
18007028V1
Passport
country
string
护照签发国三字母代码
GHA
Passport
type
string
护照类型
P
Passport
no
string
护照号码
H0000014
Passport
surname
string
姓
SPECIMEN
Passport
givenName
string
名或全部名字,保持卡面顺序
ALEX
Passport
nationality
string
国籍,按卡面原文返回
GHANAIAN
Passport
dob
string
出生日期,格式为 YYYY-MM-DD
1988-01-01
Passport
gender
string
性别,规范化为 M 或 F
M
Passport
issPlace
string
签发地
ACCRA
Passport
issDate
string
签发日期,格式为 YYYY-MM-DD
2009-08-14
Passport
expiryDate
string
到期日期,格式为 YYYY-MM-DD
2014-08-14
Passport
issAuthority
string
签发机关
PASSPORT OFFICE
Passport
line1
string
护照 MRZ 第一行,按机读区原文返回
P<GHASPECIMEN<<ALEX<<<<<<<<<<<<<
Passport
line2
string
护照 MRZ 第二行,按机读区原文返回
H0000014<8GHA8801018M1408142<<<<<<<<<3
VoterID
no
string
Voter Identification Number;
2809012503
VoterID
surname
string
姓,对应 SURNAME
OKAI BRAKO
VoterID
otherNames
string
其他姓名,对应 OTHERNAMES / OTHER NAMES;
NANA KWEKU
VoterID
dob
string
出生日期,格式为 YYYY-MM-DD
1970-12-18
VoterID
gender
string
性别,规范化为 M 或 F
M
VoterID
stationCode
string
Polling Station Code,保留字母、数字、连字符和前导零
E232003
VoterID
regDate
string
登记日期,格式为 YYYY-MM-DD
2020-07-13
全部
faces
array<object>
卡证图片中检测到的人脸位置列表;支持多张人脸,未检测到人脸时返回 []
[{"width":0.15498,"top":0.59956,"left":0.12833,"height":0.24289,"face_quality":90.09094}]
全部
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<string>
图片质量问题列表:1=模糊或低分辨率,2=反光,3=过暗,4=过亮,5=屏幕翻拍,6=卡证不完整/破损,7=卡证遮挡/涂抹;无问题返回 []
["6"]
# 喀麦隆多卡证识别 builtin-V5WgaybRCqFu2PfK7P
支持喀麦隆2025版国家身份证 CNI(IDCard)、喀麦隆驾驶证(DriverLicense)及护照(Passport)。其他国家签发的身份证、驾驶证及其他不支持或无法可靠判断的卡证返回 Other。
卡证类型
字段
类型
含义
输出示例
全部
cardType
string
卡证类型:IDCard=喀麦隆国家身份证CNI,DriverLicense=喀麦隆驾驶证,Passport=任意国家护照,Other=其他或无法可靠判断的证件
IDCard
IDCard
docNo
string
卡片证件号。来源:正面头像下方的无标签号码;仅上传背面时,可读取TD1 MRZ第一行第6–14位,即I<CMR后的9位证件号,不包含校验位。通常为9位纯数字
101091527
IDCard
idNo
string
国家身份号码。仅来自背面NUMERO CNI/NIC NUMBER标签值,通常为2个字母加8位数字。
AA18211266
IDCard
surname
string
姓。来源:正面NOM/SURNAME;仅上传背面时,来自TD1 MRZ第三行第一个<<之前的全部内容,单个<转换为空格
NKODO BINDZI
IDCard
givenName
string
名。来源:正面PRENOMS/GIVEN NAMES;仅上传背面时,来自TD1 MRZ第三行第一个<<之后的内容,单个<转换为空格并移除尾部填充符
ALEXANDRE JULIEN
IDCard
dob
string
出生日期,格式YYYY-MM-DD。来源:正面DATE DE NAISSANCE/DATE OF BIRTH;仅上传背面时,可读取TD1 MRZ第二行第1–6位YYMMDD,不包含第7位校验位
2000-09-03
IDCard
gender
string
性别,M=男、F=女。来源:正面SEXE/SEX;仅上传背面时,可读取TD1 MRZ第二行第8位
M
IDCard
expiryDate
string
卡片到期日期,格式YYYY-MM-DD。来源:正面DATE D'EXPIRATION/DATE OF EXPIRY;仅上传背面时,可读取TD1 MRZ第二行第9–14位YYMMDD,不包含第15位校验位。
2035-11-13
IDCard
fatherName
string
父亲姓名。仅来自背面NOM DU PERE/FATHER'S NAME。标签值为空时返回空字符串
FRANCOIS TANDENT A.
IDCard
motherName
string
母亲姓名。仅来自背面NOM DE LA MERE/MOTHER'S NAME
NTSOGO MARCELINE
IDCard
pob
string
出生地。仅来自背面LIEU DE NAISSANCE/PLACE OF BIRTH
AKONO
IDCard
profession
string
职业。仅来自背面PROFESSION/OCCUPATION,按卡面原文返回
EMPLOYE
IDCard
issDate
string
卡片签发日期,格式YYYY-MM-DD。仅来自背面DATE DE DELIVRANCE/DATE OF ISSUE。MRZ不提供该字段
2025-11-13
IDCard
height
string
身高。仅来自背面TAILLE/HEIGHT,移除单位并将小数逗号统一为小数点
1.69
IDCard
nationality
string
持证人国籍代码。仅来自TD1 MRZ第二行第16–18位的ICAO三字母国籍代码;普通国家代码通常与ISO 3166-1 alpha-3一致。
CMR
DriverLicense
surname
string
姓。仅来自驾驶证正面编号字段1,按卡面原文返回
NGUESSEU MONTHE
DriverLicense
givenName
string
名。仅来自驾驶证正面编号字段2,保留全部名字及原始顺序
GEORGES THOMAS
DriverLicense
dob
string
出生日期,格式YYYY-MM-DD。仅来自正面编号字段3中的日期部分;字段3通常同时包含出生日期和出生地
1979-04-18
DriverLicense
pob
string
出生地。仅来自正面编号字段3中出生日期之后的地点
DOUALA
DriverLicense
issDate
string
驾驶证整体签发日期,格式YYYY-MM-DD。仅来自正面编号字段4a
2016-10-13
DriverLicense
expiryDate
string
驾驶证整体到期日期,格式YYYY-MM-DD。仅来自正面编号字段4b
2026-10-13
DriverLicense
issuingAuthority
string
签发机关或签发办公室。仅来自正面编号字段4c,保留卡面简称
DRT CE
DriverLicense
idNo
string
持证人身份识别号码。仅来自正面编号字段4d,对应NUMERO D'IDENTIFICATION/IDENTIFICATION NUMBER;
790418502
DriverLicense
licenseNo
string
驾驶证号码。仅来自正面编号字段5,对应NUMERO DU PERMIS/NUMBER OF THE LICENCE;保留字母、数字及分隔符
CE-116279-09
DriverLicense
normalResidence
string
持证人通常居住地。仅来自正面编号字段8,对应LIEU DE RESIDENCE NORMALE/PLACE OF NORMAL RESIDENCE
YAOUNDE
DriverLicense
categories
array<string>
正面编号字段9中的准驾车型代码列表,按卡面顺序返回。BE、CE、DE等复合类别不得拆分。仅上传背面时返回[]
["B","BE","C","CE","D","DE","G"]
DriverLicense
cats
array<object>
背面类别表的详细记录。表格列为:9=类别、11=类别到期日期、12a=考试地点、12b=考试日期。仅返回自身行至少包含一个有效值的类别;星号、横线、00-00-0000及空白均视为空值。仅上传正面时返回[]
[{"cat":["B"],"expiryDate":"","testPlace":"NANGA EBOKO","testDate":""}]
DriverLicense
cats.cat
array<string>
背面表格字段9中的有效准驾车型代码。具有完全相同到期日期、考试地点和考试日期的类别可合并,保持表格顺序
["B"]
DriverLicense
cats.expiryDate
string
背面表格字段11中的类别到期日期,格式YYYY-MM-DD。占位符或不可读时返回空字符串
2026-10-13
DriverLicense
cats.testPlace
string
背面表格字段12a中的考试地点,按卡面原文返回。占位符或不可读时返回空字符串
NANGA EBOKO
DriverLicense
cats.testDate
string
背面表格字段12b中的考试日期,格式YYYY-MM-DD。占位符或不可读时返回空字符串
2016-10-13
Passport
country
string
护照签发国三字母代码。来源:护照资料页可视国家代码,采用ISO 3166-1 alpha-3格式;不返回国家全称。护照支持任意签发国家
CMR
Passport
type
string
护照类型代码,按资料页可视字段返回,例如普通护照P、外交护照D
P
Passport
no
string
护照号码,优先读取资料页可视字段Passport No./Passport Number,保留字母、数字及前导零
AA123456
Passport
surname
string
姓/Family Name,按资料页可视字段原文返回,不与givenName合并
NKODO BINDZI
Passport
givenName
string
名/Given Names,按资料页可视字段及原始顺序返回
ALEXANDRE JULIEN
Passport
nationality
string
国籍,按资料页可视Nationality字段原文返回,不强制转换为国家代码
CAMEROONIAN
Passport
dob
string
出生日期,格式YYYY-MM-DD
2000-09-03
Passport
gender
string
性别,M=男、F=女
M
Passport
issPlace
string
签发地点,按资料页可视字段原文返回
YAOUNDE
Passport
issDate
string
签发日期,格式YYYY-MM-DD
2025-11-13
Passport
expiryDate
string
到期日期,格式YYYY-MM-DD
2030-11-13
Passport
issAuthority
string
签发机关,按资料页可视字段原文返回
DGSN
Passport
line1
string
护照MRZ第一行,保留大写字母、数字及<填充符
P<CMRNKODO<BINDZI<<ALEXANDRE<JULIEN<<<<
Passport
line2
string
护照MRZ第二行,保留大写字母、数字及<填充符
AA1234567CMR0009036M3011130<<<<<<<<
全部
faces
array<object>
卡证图片中检测到的人脸位置列表;支持多张人脸,未检测到人脸时返回[]
[{"width":0.15498,"top":0.59956,"left":0.12833,"height":0.24289,"face_quality":90.09}]
全部
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<string>
图片质量问题列表:1=模糊/低分辨率,2=反光,3=过暗,4=过亮,5=屏幕翻拍,6=卡证不完整/破损,7=卡证遮挡/涂抹;无问题返回[]
["6"]
# 科特迪瓦多卡证识别 builtin-6PMasLgUL4HcdbrdAv
支持以下证件:
科特迪瓦新版及旧版国家身份证 CNI(IDCard)
科特迪瓦 CEDEAO/ECOWAS 居民卡(IDCard)
科特迪瓦非 CEDEAO/ECOWAS 居民卡(IDCard)
科特迪瓦新版及旧版驾驶证(DriverLicense)
任意国家护照(Passport)
其他国家签发的身份证、驾驶证,以及不支持、证据不足或无法可靠判断的证件返回 Other。
卡证类型
字段
类型
支持识别面
业务含义
输出示例
全部
cardType
string
正面或背面
卡证主类型:IDCard=科特迪瓦身份证或居民卡,DriverLicense=科特迪瓦驾驶证,Passport=护照,Other=其他或无法可靠判断的证件
IDCard
IDCard
identityType
string
正面;新版CNI背面
身份证件业务子类型:CIV_CNI=科特迪瓦国家身份证,CIV_ECOWAS_RESIDENT=科特迪瓦CEDEAO/ECOWAS居民卡,CIV_NON_ECOWAS_RESIDENT=科特迪瓦非CEDEAO/ECOWAS居民卡
CIV_CNI
IDCard
docNo
string
正面;新版CNI背面
卡片证件号码
CI003241525
IDCard
idNo
string
新版CNI背面
国家身份识别号码NNI
12005694014
IDCard
surname
string
正面;新版CNI背面
持证人的姓或家族名称
COULIBALY
IDCard
givenName
string
正面;新版CNI背面
持证人的名,包含多个名字时保留原有顺序
SEYDOU
IDCard
dob
string
正面;新版CNI背面
持证人的出生日期,格式为YYYY-MM-DD
2000-10-30
IDCard
gender
string
正面;新版CNI背面
持证人的性别:M=男,F=女
M
IDCard
expiryDate
string
正面;新版CNI背面
卡片的到期日期,格式为YYYY-MM-DD
2032-03-03
IDCard
pob
string
正面
持证人的出生地点
ADJAMÉ (CIV)
IDCard
profession
string
新版CNI背面
持证人的职业
ELEVE
IDCard
issDate
string
正面或背面,视证件版本而定
卡片的签发日期,格式为YYYY-MM-DD
2022-03-03
IDCard
issPlace
string
正面或背面,视证件版本而定
卡片的签发地点
ABIDJAN
IDCard
height
string
正面
持证人的身高,统一使用不带单位的小数形式
1.79
IDCard
nationality
string
正面;新版CNI背面
持证人的国籍,按证件显示形式返回,可能为国籍文字或三字母国籍代码
CIV
DriverLicense
surname
string
正面
持证人的姓或家族名称
SETIEN
DriverLicense
givenName
string
正面
持证人的名,包含多个名字时保留原有顺序
Pascale
DriverLicense
dob
string
正面
持证人的出生日期,格式为YYYY-MM-DD
1985-12-30
DriverLicense
pob
string
正面
持证人的出生地点
Abidjan
DriverLicense
issDate
string
正面
驾驶证的签发日期,格式为YYYY-MM-DD
2013-01-04
DriverLicense
issPlace
string
正面
驾驶证的签发地点
Abidjan
DriverLicense
expiryDate
string
正面,视证件版本而定
整张驾驶证的到期日期,格式为YYYY-MM-DD
2028-01-04
DriverLicense
issuingAuthority
string
正面
驾驶证签发机关名称
MINISTÈRE DES TRANSPORTS
DriverLicense
idNo
string
背面
与持证人关联的身份证件号码
CI003241525
DriverLicense
licenseNo
string
正面
驾驶证号码
SETH01-13-001570375BC
DriverLicense
normalResidence
string
正面或背面,视证件版本而定
持证人的通常居住地或联系地址
ABIDJAN
DriverLicense
categories
array<string>
正面或背面
持证人具备的准驾车型代码列表,按照证件显示顺序返回
["A","B","C","D","E"]
DriverLicense
cats
array<object>
背面
各准驾车型的详细有效期记录
[{"cat":["B"],"issueDate":"2017-06-29","expiryDate":"PERMANENT"}]
DriverLicense
cats.cat
array<string>
背面
当前有效期记录对应的准驾车型代码列表
["B"]
DriverLicense
cats.issueDate
string
背面
对应准驾车型资格的生效日期,格式为YYYY-MM-DD
2017-06-29
DriverLicense
cats.expiryDate
string
背面
对应准驾车型资格的到期日期,格式为YYYY-MM-DD;长期有效时可能返回PERMANENT
PERMANENT
Passport
country
string
护照资料页
护照签发国家或地区的三字母代码,采用ISO 3166-1 alpha-3格式
CIV
Passport
type
string
护照资料页
护照类型代码,例如P表示普通护照,D表示外交护照
P
Passport
no
string
护照资料页
护照号码
23AE12345
Passport
surname
string
护照资料页
持证人的姓或家族名称
KOUASSI
Passport
givenName
string
护照资料页
持证人的名,包含多个名字时保留原有顺序
JEAN MARC
Passport
nationality
string
护照资料页
持证人的国籍,按护照显示内容返回
IVOIRIENNE
Passport
dob
string
护照资料页
持证人的出生日期,格式为YYYY-MM-DD
1990-03-15
Passport
gender
string
护照资料页
持证人的性别:M=男,F=女
M
Passport
issPlace
string
护照资料页
护照签发地点
ABIDJAN
Passport
issDate
string
护照资料页
护照签发日期,格式为YYYY-MM-DD
2022-08-20
Passport
expiryDate
string
护照资料页
护照到期日期,格式为YYYY-MM-DD
2032-08-19
Passport
issAuthority
string
护照资料页
护照签发机关名称
S/DPAF
Passport
line1
string
护照资料页
护照机读区MRZ第一行原文
P<CIVKOUASSI<<JEAN<MARC<<<<<<<<
Passport
line2
string
护照资料页
护照机读区MRZ第二行原文
23AE12345CIV9003155M3208190<<<<<<<<
全部
faces
array<object>
当前上传图片
图片中识别到的人脸位置及质量信息列表;未检测到人脸时返回[]
[{"width":0.15498,"top":0.59956,"left":0.12833,"height":0.24289,"face_quality":90.09}]
全部
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
90.09094250091916
全部
quality
string
当前上传图片
图片质量总体判定:1=关键视觉信息基本清晰可用,0=图片可能存在影响识别或使用的问题
1
全部
issues
array<string>
当前上传图片
图片质量问题列表:1=模糊或低分辨率,2=反光,3=过暗,4=过亮,5=屏幕翻拍,6=证件明显不完整,7=证件重要内容被遮挡或涂抹
["6"]
# 玻利维亚多卡证识别 builtin-up7EeGn94S0lSc0Y01
支持玻利维亚身份证、玻利维亚驾驶证以及任意国家签发的护照。非玻利维亚身份证、非玻利维亚驾驶证及无法确认类型的证件返回 Other。
卡证类型
字段
类型
含义
正反面
输出示例
全部
cardType
string
卡证类型;IDCard=玻利维亚身份证,DriverLicense=玻利维亚驾驶证,Passport=护照,Other=其他或无法确认的证件
正面或背面
IDCard
IDCard
idNo
string
身份证号码,包含卡面明确显示的附加码(如有)
正面或背面
4942700
IDCard
series
string
证件系列号
正面
44333
IDCard
section
string
证件分区号
正面
44242
IDCard
surname
string
持证人姓氏
正面或背面
NINA RAMOS
IDCard
givenName
string
持证人名字
正面或背面
NATIVIDAD
IDCard
dob
string
出生日期,格式为 YYYY-MM-DD
正面或背面
1972-12-25
IDCard
gender
string
性别,M=男,F=女
背面
F
IDCard
nationality
string
持证人国籍,通常返回 ISO 3166-1 alpha-3 三字母代码
背面
BOL
IDCard
issDate
string
证件签发日期,格式为 YYYY-MM-DD
正面
2024-09-18
IDCard
expiryDate
string
证件到期日期,格式为 YYYY-MM-DD;长期有效时可返回卡面原文
正面或背面
2029-09-18
IDCard
pob
string
持证人出生地
背面
LA PAZ - INGAVI - HAHUIRA PAMPA
IDCard
address
string
持证人居住地址
背面
RESD. EN JAHUIRA PAMPA - PROV. INGAVI
IDCard
profession
string
持证人职业或工作类别
背面
AMA DE CASA
IDCard
civilStatus
string
婚姻状况,按卡面原文返回
背面
SOLTERA
IDCard
bloodType
string
血型,包含 ABO 血型及 Rh 因子(如有)
背面
A RH(+)
DriverLicense
licenseNo
string
驾驶证号码
正面或背面
7738003
DriverLicense
fullName
string
持证人完整姓名
正面或背面
DEL CASTILLO CARLOS EDUARDO
DriverLicense
dob
string
出生日期,格式为 YYYY-MM-DD
正面或背面
1988-12-27
DriverLicense
gender
string
性别,M=男,F=女
正面或背面
M
DriverLicense
nationality
string
持证人国籍,返回 ISO 3166-1 alpha-3 三字母代码
正面或背面
BOL
DriverLicense
issDate
string
驾驶证签发日期,格式为 YYYY-MM-DD
正面或背面(依版式)
2025-05-06
DriverLicense
expiryDate
string
驾驶证到期日期,格式为 YYYY-MM-DD
正面或背面
2030-05-06
DriverLicense
category
string
准驾类别代码
正面或背面
P
DriverLicense
bloodType
string
血型,包含 ABO 血型及 Rh 因子(如有)
背面
O RH(+)
DriverLicense
correctiveLenses
string
是否要求使用视力矫正眼镜,通常返回 SÍ 或 NO
背面
SÍ
DriverLicense
hearingAids
string
是否要求使用助听设备,通常返回 SÍ 或 NO
背面
NO
DriverLicense
emergencyPhone
string
紧急联系电话
背面
75247335
Passport
country
string
护照签发国的 ISO 3166-1 alpha-3 三字母代码
正面(资料页)
BOL
Passport
type
string
护照或旅行证件类型代码
正面(资料页)
P
Passport
no
string
护照号码
正面(资料页)
PE1234567
Passport
surname
string
持证人姓氏
正面(资料页)
GARCIA
Passport
givenName
string
持证人名字
正面(资料页)
MARIA ELENA
Passport
nationality
string
持证人国籍,按证件内容返回
正面(资料页)
BOL
Passport
dob
string
出生日期,格式为 YYYY-MM-DD
正面(资料页)
1990-01-15
Passport
gender
string
性别,M=男,F=女
正面(资料页)
F
Passport
issPlace
string
护照签发地点
正面(资料页)
LA PAZ
Passport
issDate
string
护照签发日期,格式为 YYYY-MM-DD
正面(资料页)
2022-06-01
Passport
expiryDate
string
护照到期日期,格式为 YYYY-MM-DD
正面(资料页)
2032-06-01
Passport
issAuthority
string
护照签发机关
正面(资料页)
DIRECCIÓN GENERAL DE MIGRACIÓN
Passport
line1
string
护照机读区第一行原文
正面(资料页)
P<BOLGARCIA<<MARIA<ELENA<<<<<<<<<
Passport
line2
string
护照机读区第二行原文
正面(资料页)
PE1234567BOL9001158F3206012<<<<<<<<<<
全部
faces
array<object>
图片中检测到的人脸位置列表;支持多张人脸,未检测到时返回 []
正面或背面
[{"width":0.15,"top":0.20,"left":0.08,"height":0.26,"face_quality":90.1}]
全部
faces.width
float
人脸框宽度,占原图宽度的比例
正面或背面
0.15
全部
faces.top
float
人脸框左上角纵坐标,占原图高度的比例
正面或背面
0.20
全部
faces.left
float
人脸框左上角横坐标,占原图宽度的比例
正面或背面
0.08
全部
faces.height
float
人脸框高度,占原图高度的比例
正面或背面
0.26
全部
faces.face_quality
float
人脸图像质量得分,范围为 0~100
正面或背面
90.1
全部
quality
string
图片质量辅助判定;1=关键视觉信息基本清晰可用,0=存在可能影响识别或使用的问题
正面或背面
1
全部
issues
array<string>
图片质量问题代码;1=模糊或低分辨率,2=反光,3=过暗,4=过亮,5=屏幕翻拍,6=证件不完整,7=证件内容被遮挡;无问题返回 []
正面或背面
["5"]
# 越南身份证 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
当前接口支持以下证件:
Aadhaar:印度 Aadhaar 身份证
PAN:印度永久账户号码卡(PAN Card)
Passport:护照
Other:无法确认或暂不支持的其他证件
图片质量检测和人脸检测为可选能力;未启用时不返回对应字段。
卡证类型
字段
类型
中文说明
支持识别面
示例
全部
cardType
string
卡证类型,可选值:Aadhaar、PAN、Passport、Other
正面、反面或护照资料页
Aadhaar
Aadhaar
no
string
Aadhaar 身份号码,以连续数字字符串返回
正面、反面
342506531151
Aadhaar
name
string
持证人姓名,按证件显示返回
正面
SID MALHOTRA
Aadhaar
birth
string
持证人出生日期,格式为 YYYY-MM-DD
正面
2000-05-28
Aadhaar
gender
string
持证人性别,M=男性、F=女性
正面
F
Aadhaar
address
string
持证人完整居住地址,按证件可见语言返回;多行地址合并为一个字符串
反面
C/O SURESH KUMAR 12 MG ROAD NEW DELHI DELHI 110001
PAN
no
string
永久账户号码(PAN),通常由 10 位大写字母和数字组成
正面
BNZPM2501F
PAN
holder
string
PAN 持卡人或机构名称
正面
D MANIKANDAN
PAN
parentName
string
个人 PAN 卡上显示的父亲或母亲姓名;非个人主体未显示时返回空字符串
正面
DURAISAMY
PAN
birth
string
个人出生日期或机构成立、注册、组建日期,格式为 YYYY-MM-DD
正面
1986-07-16
Passport
country
string
护照签发国三字母代码
护照资料页
IND
Passport
type
string
护照类型代码,例如普通护照 P、外交护照 D
护照资料页
P
Passport
no
string
护照号码
护照资料页
Z1234567
Passport
surname
string
持证人姓氏或家族名
护照资料页
SHARMA
Passport
givenName
string
持证人名字,保持证件显示顺序
护照资料页
RAHUL KUMAR
Passport
nationality
string
持证人国籍,按护照显示返回
护照资料页
INDIAN
Passport
dob
string
持证人出生日期,格式为 YYYY-MM-DD
护照资料页
1990-03-15
Passport
gender
string
持证人性别,M=男性、F=女性
护照资料页
M
Passport
issPlace
string
护照签发地点
护照资料页
DELHI
Passport
issDate
string
护照签发日期,格式为 YYYY-MM-DD
护照资料页
2022-08-20
Passport
expiryDate
string
护照到期日期,格式为 YYYY-MM-DD
护照资料页
2032-08-19
Passport
issAuthority
string
护照签发机关
护照资料页
PASSPORT OFFICE DELHI
Passport
line1
string
护照机读区第一行,保留字母、数字和 < 填充符
护照资料页
P<INDSHARMA<<RAHUL<KUMAR<<<<<<<<<
Passport
line2
string
护照机读区第二行,保留字母、数字和 < 填充符
护照资料页
Z1234567<IND9003155M3208191<<<<<<<<<<
全部(可选)
faces
array<object>
图片中检测到的人脸位置列表;未检测到人脸时返回 []
提交的证件图片
[{"width":0.15498,"top":0.59956,"left":0.12833,"height":0.24289,"face_quality":90.09}]
全部(可选)
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
提交的证件图片
90.09
全部(可选)
quality
string
图片质量总体辅助判定,1=关键视觉信息基本清晰可用,0=可能存在影响识别或使用的问题
提交的证件图片
1
全部(可选)
issues
array<string>
图片质量问题列表:1=模糊或低分辨率,2=反光,3=过暗,4=过亮,5=屏幕翻拍,6=卡证不完整或破损,7=卡证遮挡或涂抹;无问题返回 []
提交的证件图片
["6"]
# 南非身份证 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
支持肯尼亚身份证IDCard(包含公民身份证、Huduma/Maisha Card 和 Foreigner Certificate/Alien Card)、驾驶证DriverLicense及护照Passport,上述类型之外的卡证返回Other。
卡证类型
字段
类型
含义
输出示例
全部
cardType
string
卡证类型:IDCard=肯尼亚身份证/外国人身份证明,DriverLicense=驾驶证,Passport=护照,Other=其他
IDCard
IDCard
serialNo
string
证件序列号。来源:公民证正面 SERIAL NUMBER 或独立竖排序列号;旧版 IDKYA MRZ 第一行;新版 IDKEN MRZ 第二行中 KEN 后的序列号;Foreigner Certificate 正面 SERIAL NUMBER 或 ACKYA/ACKEN MRZ 第一行。
259443743
IDCard
no
string
持证人主身份号码。来源:公民证正面 ID NUMBER、HUDUMA NAMBA、MAISHA NAMBA;旧版 IDKYA MRZ 第二行 <B0... 中的身份证号;新版 IDKEN MRZ 第一行;Foreigner Certificate 正面 INDIV. NUMBER 等身份号码
487499952
IDCard
name
string
持证人全名。来源:正面 FULL NAME(S) 或 SURNAME + GIVEN NAME(S);也支持公民证或 Foreigner Certificate 背面 MRZ 姓名行。按卡面/MRZ顺序合并并移除 < 填充符
OTAWO KELVIN ODHIAMBO
IDCard
dob
string
出生日期,格式 YYYY-MM-DD。来源:正面 DATE OF BIRTH;也支持 IDKYA、IDKEN、ACKYA/ACKEN MRZ 出生日期段
2006-07-28
IDCard
gender
string
性别,M=男、F=女。来源:正面 SEX/GENDER;也支持 IDKYA、IDKEN、ACKYA/ACKEN MRZ 性别标记
M
IDCard
nationality
string
国籍。来源:正面 NATIONALITY;也支持新版 IDKEN 或 Foreigner Certificate ACKYA/ACKEN MRZ 中明确编码的国籍。
KEN
IDCard
pob
string
出生地。来源:正面 PLACE OF BIRTH 或 DISTRICT OF BIRTH。不得使用背面的 COUNTY、SUB-COUNTY、DISTRICT、DIVISION、LOCATION、SUB-LOCATION 或外国人居住地址回填
RARIEDA
IDCard
issPlace
string
签发地点。来源:正面 PLACE OF ISSUE。
MADIANY
IDCard
issDate
string
签发日期,格式 YYYY-MM-DD。来源:正面或普通背面明确标注的 DATE OF ISSUE;旧版公民证 IDKYA MRZ 中性别后的日期也表示签发日期。
2026-05-04
IDCard
expiryDate
string
到期日期,格式 YYYY-MM-DD。来源:正面 DATE OF EXPIRY/EXPIRY DATE/VALID UNTIL;也支持新版 IDKEN 和 Foreigner Certificate ACKYA/ACKEN MRZ 的到期日期。旧版 IDKYA MRZ 中性别后的日期是签发日期,不是到期日期
2036-04-24
IDCard
identityType
string
身份类别:CITIZEN=肯尼亚公民身份证/Huduma/Maisha Card,FOREIGNER=Foreigner Certificate/Alien Card。支持依据正面标题、普通背面特征或 MRZ 前缀识别:IDKYA/IDKEN 为 CITIZEN,ACKYA/ACKEN 为 FOREIGNER
CITIZEN
IDCard
foreignerCertificateNo
string
Foreigner Certificate 背面独立打印的 FN 前缀证件号码,仅适用于 identityType=FOREIGNER;通常来自普通背面
FN00252243
IDCard
rNo
string
Foreigner Certificate 背面的 R. NUMBER/R NUMBER,仅适用于 identityType=FOREIGNER;
140162
IDCard
residentialAddress
string
Foreigner Certificate 背面的 RESIDENTIAL ADDRESS,仅适用于 identityType=FOREIGNER,按卡面原文返回
CITY PARK PLT 209-871-7 NBI
IDCard
immigrationStatus
string
Foreigner Certificate 背面的 IMMIGRATION STATUS,仅适用于 identityType=FOREIGNER,按卡面原文返回
KDP/46051
IDCard
passportNo
string
Foreigner Certificate 背面的 PASSPORT NUMBER/PASSPORT NO.,仅适用于 identityType=FOREIGNER;
A12345678
IDCard
district
string
公民身份证普通背面明确标注的 DISTRICT。仅表示背面行政区划,不等同于正面的 DISTRICT OF BIRTH
NYANDARUA NORTH
IDCard
division
string
公民身份证普通背面明确标注的 DIVISION,按卡面原文返回
MADIANY
IDCard
location
string
公民身份证普通背面明确标注的 LOCATION
SOUTH UYOMA
IDCard
subLocation
string
公民身份证普通背面明确标注的 SUB-LOCATION/SUB LOCATION/SUBLOCATION
LIETA
DriverLicense
surname
string
姓,仅来自驾驶证正面 SURNAME;
WILLIAMS
DriverLicense
otherName
string
其他姓名/名,仅来自驾驶证正面 OTHER NAME/OTHER NAMES,保持卡面顺序
JOHN CITIZEN
DriverLicense
IDNo
string
肯尼亚国家身份证号,仅来自驾驶证正面 NATIONAL ID No./NATIONAL ID NUMBER;
00000000
DriverLicense
no
string
驾驶证号,仅来自正面 LICENCE No./LICENSE No./DRIVING LICENCE No./DRIVER LICENCE No.
WLX165
DriverLicense
dob
string
出生日期,仅来自正面,格式 YYYY-MM-DD
1986-12-16
DriverLicense
issDate
string
驾驶证整体签发日期,仅来自正面,格式 YYYY-MM-DD;
2017-11-21
DriverLicense
gender
string
性别,仅来自正面,M=男、F=女
M
DriverLicense
expiryDate
string
驾驶证整体到期日期,仅来自正面,格式 YYYY-MM-DD;
2020-11-21
DriverLicense
bloodGroup
string
血型,仅来自正面 BLOOD GROUP,按卡面原文返回
B+
DriverLicense
countryOfResidence
string
居住地区,仅来自正面 COUNTRY OF RESIDENCE 或 COUNTY OF RESIDENCE;字段名为 countryOfResidence,但肯尼亚卡面常见标签为 COUNTY OF RESIDENCE
NAIROBI
DriverLicense
cats
array<object>
背面 CATEGORIES OF VEHICLES 表中的准驾车型有效期列表。只返回自身行至少有一个可读日期的类别;起止日期相同的类别合并到同一对象;仅上传正面时返回 []
[{"cat":["B","C","E"],"issueDate":"2017-11-21","expiryDate":"2020-11-21"}]
DriverLicense
cats.cat
array<string>
同一组签发日期和到期日期对应的准驾车型代码;每个类别必须在自己的表格行中具有可读签发日期和/或到期日期
["B","C","E"]
DriverLicense
cats.issueDate
string
对应准驾车型所在行的签发日期,格式 YYYY-MM-DD;如果该行只有到期日期可读,则返回空字符串
2017-11-21
DriverLicense
cats.expiryDate
string
对应准驾车型所在行的到期日期,格式 YYYY-MM-DD;如果该行只有签发日期可读,则返回空字符串
2020-11-21
Passport
country
string
护照签发国三字母代码
KEN
Passport
type
string
护照类型代码,例如普通护照 P、外交护照 D
P
Passport
no
string
护照号码,优先读取资料页可视字段 Passport No./Passport Number,保留字母和数字
A1234567
Passport
surname
string
姓/Family Name,按资料页原文返回,不与 givenName 合并
OTIENO
Passport
givenName
string
名/Given Names,按资料页原文及顺序返回
JAMES OMONDI
Passport
nationality
string
国籍,按资料页可视字段原文返回,不强制转换为国家代码
KENYAN
Passport
dob
string
出生日期,格式 YYYY-MM-DD
1990-03-15
Passport
gender
string
性别,M=男、F=女
M
Passport
issPlace
string
签发地点,按资料页可视字段原文返回
NAIROBI
Passport
issDate
string
签发日期,格式 YYYY-MM-DD
2022-08-20
Passport
expiryDate
string
到期日期,格式 YYYY-MM-DD
2032-08-20
Passport
issAuthority
string
签发机关,按资料页可视字段原文返回
DIRECTORATE OF IMMIGRATION SERVICES
Passport
line1
string
护照 MRZ 第一行,保留大写字母、数字及 < 填充符
P<KENOTIENO<<JAMES<OMONDI<<<<<<<<<
Passport
line2
string
护照 MRZ 第二行,保留大写字母、数字及 < 填充符
A1234567<KEN9003155M3208201<<<<<<<<<<
全部
faces
array<object>
卡证图片中检测到的人脸位置列表;支持多张人脸,未检测到人脸时返回 []
[{"width":0.15498,"top":0.59956,"left":0.12833,"height":0.24289,"face_quality":90.09}]
全部
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<string>
图片质量问题列表:1=模糊/低分辨率,2=反光,3=过暗,4=过亮,5=屏幕翻拍,6=卡证不完整/破损,7=卡证遮挡/涂抹;无问题返回 []
["6"]
# 阿根廷身份证 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
服务器内部错误,当此类错误发生时请再次请求,如果持续出现此类错误,请及时联系客服或商务
# 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,
"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
}
},
"pages": 1
}
}
# 8.2 错误相应返回示例
1 2 3 4 5 {
"request_id": "d5f8b2e4-7c1a-4d3f-9b6e-2a4c8d3b5e6f",
"time_used": 150,
"error": "FILE_TOO_LARGE"
}