护照 OCR

读取任何 ICAO 9303 护照的机读区，返回持证人信息、照片，以及各字段是否与其校验位一致。

POST/v3/store/ekyc/passport试一试

• 价格0.75 IC每页
• 实测95.5%
• 承载15,000 本/小时
• 累计调用317.1K次

• v2.0.5-20260825
• 更新 2026 年 8 月 25 日
• 运行中
• 基准报告 (PDF)

输入

输出POST /v3/store/ekyc/passport

number

AA1234567

valid_number

true

surname

SPECIMEN

names

SOMCHAI

date_of_birth

01/01/90

valid_date_of_birth

true

expiration_date

31/12/30

valid_expiration_date

true

nationality

THA

valid_composite

true

全部字段见“响应”一节

请求

curl -X POST https://api.iapp.co.th/v3/store/ekyc/passport \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@passport.jpg"

响应

200成功。字段在"响应"一节说明。

{
    "number": "AA1234567",
    "valid_number": true,
    "surname": "SPECIMEN",
    "names": "SOMCHAI",
    "date_of_birth": "01/01/90",
    "valid_date_of_birth": true,
    "expiration_date": "31/12/30",
    "valid_expiration_date": true,
    "nationality": "THA",
    "valid_composite": true
}

请求

multipart/form-data，每次一本护照；PDF 每页返回一条结果。

请求头

apikeystring必填

您的 API 密钥，在控制台的 API Keys 中创建。

请求体

filefile必填

护照资料页。JPEG、PNG、WEBP 或 PDF。

fieldsstring

以逗号分隔的响应字段子集。省略则返回全部。

optionsstring

以逗号分隔。segmentation 校正方向不正的图像，耗时约两倍；no_thresh 跳过 MRZ 裁剪区的预处理。

旧路径 /passport-ocr、/passport-ocr/v2 与 /passport-ocr/v2/ocr 指向同一服务，价格相同。

响应

一个扁平对象。请以 valid_number 为准：为 false 时，该号码不可能属于真实护照，请重新拍摄。

numberstring

护照号

surnamenames

与 MRZ 上印刷的一致

date_of_birthexpiration_date

DD/MM/YY；MRZ 不编码世纪

sex

M、F，未注明时为 <

nationalitycountry

ISO 3166-1 alpha-3；country 为签发国

personal_number

许多护照为空

typemrz_type

普通护照为 P<；护照 MRZ 为 TD3

face

照片，Base64 JPEG

valid_numbervalid_date_of_birthvalid_expiration_datevalid_personal_numbervalid_composite

各值是否与其校验位一致；valid_composite 针对整个 MRZ

valid_score

通过校验的校验位占比，0 至 100

诊断字段与状态码

字段	含义
check_number、check_date_of_birth、check_expiration_date、check_personal_number、check_composite	印刷的校验位
raw_text	MRZ 两行，每行 44 个字符
method	定位 MRZ 区域的方式
inference	秒
file_name、message、status_code	成功时为 Success 与 200

找不到 MRZ 时请求仍返回 200，并带有 Error Message 字段；options=segmentation 通常能解决方向不正的图像。服务自身的状态码：415 不支持的文件类型，461 未附加文件，462 表单中没有 file 键。

详情

实测

在 266 本护照的基准上以 MRZ 自带的校验位评分：返回的字段要么满足护照上印刷的校验位，要么不满足。

指标	结果
MRZ 解析	100%
护照号通过校验	96.2%
出生日期通过校验	99.2%
有效期通过校验	98.1%
护照号、出生日期与有效期全部通过	95.5%
中位耗时	每本 0.4 秒
持续吞吐	每小时 15,000 本，生产环境，2026 年 8 月

校验位只有一位十进制数字，约十分之一的误读会偶然通过，真实准确率略低于以上数字。方法：基准报告 (PDF)。

限制

• 仅读取机读区；视读区的文字不提取。

数据处理

图像在内存中处理，响应返回后不保留。服务符合 GDPR 与 PDPA。如需护照数据不出您网络的本地部署，请联系我们。

更新日志

版本	日期	变更
v2.0.5-20260825	2026 年 8 月 25 日	日期返回 DD/MM/YY，即自 2023 年以来的格式，因此解析过临时 YYMMDD 格式的调用方需更新；新增 type、mrz_type、method 与 valid_score。
v2.0.3-20260825	2026 年 8 月 25 日	新识别引擎与 MRZ 结构校验：完全通过校验的读取从 58.6% 升至 95.5%，返回 valid_date_of_birth 与 valid_expiration_date，可本地部署。
v2.0	2023 年 2 月	MRZ 提取，含面部图像与校验位标志。