本文介绍中国护照识别RecognizeChinapassport的语法及示例。

功能描述

RecognizeChinapassport可以识别中国护照关键字段内容，包括：中文姓名（带拼音）、护照号码、护照人身份ID、性别、英文姓名、出生日期、出生地（带拼音）、国籍、发证日期、结束日期、发证地址（带拼音）、MRZ码第一行、MRZ码第二行、护照类型。

前提条件

请确保您已开通文字识别服务，详情请参见服务开通。

输入限制

  • 图片格式：JPEG、JPG、PNG、BMP、GIF。
  • 图片大小：图片二进制数据的base64编码后大小不超过2MB。
  • 图像分辨率：不限制图片分辨率，但图片分辨率太高可能会导致API识别超时，超时时间为5秒。
  • URL地址中不能包含中文字符。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 RecognizeChinapassport

要执行的操作。取值：RecognizeChinapassport。
ImageURL String 是 https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/passport.jpg

图片URL地址。当前仅支持上海地域的OSS链接，如何生成URL请参见生成URL。

返回数据

名称 类型 示例值 描述
Data Struct

返回的结果数据内容。
Authority String 公安部出入境管理局

签发机关。
BirthDate String 19861030

出生日期。
BirthDay String 861030

生日。
BirthPlace String 广西

出生地。
BirthPlaceRaw String 广西/GUANGXI

出生地带拼音。
Country String CHN

国籍。
ExpiryDate String 20230501

到期日期。
ExpiryDay String 230501

到期日期。
IssueDate String 20130502

发证日期。
IssuePlace String 广西

发证地址。
IssuePlaceRaw String 广西/GUANGXI

发证地址带拼音。
LineOne String P0CHNWANG<<JING<<<<<<<<<<<<<<<<<<<<<<<<<<

MRZ码第二行。
LineZero String E203545580CHN8610304M2305019MNPELOLIOKLPA938

MRZ码第一行。
Name String WANG.JING

英文姓名。
NameChinese String 汪婧

中文姓名。
NameChineseRaw String 汪婧WANGJING

中文姓名包含拼音。
PassportNo String E20354xxxx

护照号码。
PersonId String MNPELOLIOKLPA9

护照人身份ID。
Sex String M

性别。male（男性），female（女性）。
SourceCountry String CHN

国籍。
Success Boolean true

识别是否成功。
Type String P0

护照类型。
RequestId String UUID

请求ID。

示例

请求示例

http(s)://ocr.cn-shanghai.aliyuncs.com/?Action=RecognizeChinapassport
&ImageURL=https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/passport.jpg
&<公共请求参数>

正常返回示例

XML 格式 

<RequestId>UUID</RequestId>
<Data>
    <Authority>公安部出入境管理局*</Authority>
    <BirthDate>19861030</BirthDate>
    <BirthDay>861030</BirthDay>
    <BirthPlace>广西</BirthPlace>
    <BirthPlaceRaw>广西/GUANGXI</BirthPlaceRaw>
    <Country>CHN</Country>
    <ExpiryDate>20230501</ExpiryDate>
    <ExpiryDay>230501</ExpiryDay>
    <IssueDate>20130502</IssueDate>
    <IssuePlace>广西</IssuePlace>
    <IssuePlaceRaw>广西/GUANGXI</IssuePlaceRaw>
    <LineZero>P0CHNWANG&lt;&lt;JING&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;</LineZero>
    <LineOne>E203545580CHN8610304M2305019MNPELOLIOKLPA938</LineOne>
    <Name>WANG.JING</Name>
    <NameChinese>汪婧</NameChinese>
    <NameChineseRaw>汪婧WANGJING</NameChineseRaw>
    <PassportNo>E20354xxxx</PassportNo>
    <PersonId>MNPELOLIOKLPA9</PersonId>
    <Sex>M</Sex>
    <SourceCountry>CHN</SourceCountry>
    <Success>true</Success>
    <Type>P0</Type>
</Data>

JSON 格式 

{
    "RequestId": "UUID",
    "Data": {
        "Authority": "公安部出入境管理局*",  
        "BirthDate": "19861030", 
        "BirthDay": "861030",   
        "BirthPlace": "广西", 
        "BirthPlaceRaw":"广西/GUANGXI", 
        "Country": "CHN",                   
        "ExpiryDate": "20230501",          
        "ExpiryDay": "230501",            
        "IssueDate": "20130502",      
        "IssuePlace": "广西",           
        "IssuePlaceRaw":"广西/GUANGXI",  
        "LineZero": "P0CHNWANG<<JING<<<<<<<<<<<<<<<<<<<<<<<<<<",
        "LineOne": "E203545580CHN8610304M2305019MNPELOLIOKLPA938",
        "Name": "WANG.JING",                    
        "NameChinese": "汪婧",                     
        "NameChineseRaw": "汪婧WANGJING",            
        "PassportNo": "E20354xxxx",             
        "PersonId": "MNPELOLIOKLPA9",          
        "Sex": "M",                            
        "SourceCountry": "CHN",                  
        "Success": true,
        "Type": "P0"                       
    }
}

错误码

关于中国护照识别的错误码，详情请参见常见错误码。