Passport OCR & MRZ Verification

Passport OCR & MRZ verification for KYC: validate ICAO 9303 MRZ (TD1/TD2/TD3) check digits, OCR the whole passport page, and auto-verify the printed fields against the MRZ. Images are never stored.

原始信息汇总

数据集概述：护照OCR与MRZ验证API

该数据集提供了一组用于护照识别与验证的API接口，旨在将护照照片转化为可信的身份数据，适用于KYC（了解你的客户）和用户引导流程。其核心功能包括MRZ（机器可读区）校验、护照信息与MRZ的交叉验证，以及全页面OCR扫描。

主要功能与端点

该数据集由三个核心端点组成，每个端点针对不同的验证需求：

端点	功能描述	请求类型与主体
Validate Passport MRZ	解析并验证ICAO 9303标准的MRZ（支持TD1、TD2、TD3格式），通过纯算法校验所有校验位，具有毫秒级延迟。	POST /passport/mrz/validation，请求体为包含MRZ字符串的JSON。
Verify Passport Against MRZ	将已知的护照信息（如OCR结果或表单数据）与MRZ进行逐字段比对，以识别篡改或OCR错误。	POST /passport/mrz/match-verification，请求体需包含mrz及待比对的passport字段（JSON格式）。
Scan Passport Document	上传护照照片页，自动执行OCR识别所有字段和MRZ，并运行验证与交叉检查，最终返回一致性结论。	POST /passport/scan，请求体为multipart/form-data格式，包含名为front的图片文件。

验证逻辑与输出关键字段：

• MRZ验证：响应包含valid（所有校验位是否通过）、format（MRZ格式）、解析出的姓名、证件号、出生日期等字段及每个字段的校验位是否有效。
• 交叉验证：响应包含match（提供的所有字段是否与MRZ完全一致）、mrzValid（MRZ自身的校验是否通过）以及fields[]数组，其中详细列出每个字段的比对状态。
• 扫描验证：响应整合了上述两项验证结果，并提供一个总体的 selfConsistent布尔值作为最终结论。同时会返回结构化的fields数据、包含每个字段OCR置信度（0-1）的rawFields数据以及错误提示issues。

数据集核心价值与使用建议

该API的核心价值在于其流程化、多层次的验证能力，能有效区分低质量图片导致的假阴性与潜在的欺诈篡改，其推荐使用逻辑如下：

• selfConsistent: true：所有检查均通过，可视为有效护照，应予以接受。
• selfConsistent: false且mrzValid: false：通常表明照片质量不佳，导致MRZ校验失败，建议要求用户重新拍摄，而非直接拒绝。
• selfConsistent: false且部分字段比对失败：表明印刷字段与MRZ信息不一致，存在篡改的可能，需转人工进行详细审核。

此外，API支持对单个字段的OCR置信度（由rawFields提供）设定判断门槛，作为额外的质量控制手段。

数据与隐私说明

• 数据处理：所有图片均在请求过程中处理，不会被存储。
• 输入限制：支持上传的图片最大为20MB，超出后会自动缩小尺寸。
• 技术要求：MRZ文本需为2-3行，并以换行符 分隔；姓名匹配遵循ICAO音译规则（如Ö转为OE）；所有日期输出均为ISO格式（yyyy-MM-dd）。

错误处理

所有端点均返回一致的错误JSON格式。错误代码及含义如下：

状态码	错误场景
400	请求格式错误，如MRZ格式不正确、图片无法读取或缺少文件。
413	上传的文件大小超过20MB限制。
429	请求频率超过当前套餐的速率限制。
502	文档处理服务暂时不可用，建议稍后重试。