短信签名快速报备,马上注册寻求客户经理支持!
所有文档
文字识别
文档中心 > 文字识别 > 护照(港澳台地区及境外护照)OCR识别

护照(港澳台地区及境外护照)OCR识别


提交查询

1、接口描述

提交查询

2、请求地址

https://api.ihuyi.com/ocr/passportintl/Submit.json

3、请求头说明

参数名称 参数值描述 示例 类型 必填
Content-Type 内容类型,固定值 application/x-www-form-urlencoded string

4、请求参数说明

参数名称 参数值描述 示例 类型 必填
account APIID(用户中心【认证核验】-【OCR识别】-【产品总览】查看) xxxxxxxx string
password 1、APIKEY(用户中心【认证核验】-【OCR识别】-【产品总览】查看)
2、动态密码(生成动态密码方式请看该文档末尾的说明)
xxxxxxxxx string
img_file 图片文件(multipart file,小于1MB,支持jpg、png、bmp) file
img_url 图片url(img_file、img_url二选一传递,小于1MB,支持jpg、png、bmp) string
time Unix时间戳(10位整型数字,当使用动态密码方式时为必填) 1623643787 string

5、响应参数

参数名称 参数值描述 示例 类型 必返
code 返回值为2时,表示提交成功 2|1 int
msg 提交结果描述 提交成功|提交失败 string
idcardid 当提交成功后,此字段为流水号,否则为0或空 16236437872836|0 string
result 识别结果 object
info[] 数据 array
ID 护照ID C10965000 string
Name 姓名 ZHANG SAN string
DateOfBirth 出生日期 19600424 string
Sex 性别(F女,M男) M string
DateOfExpiration 有效期 20330823 string
IssuingCountry 发行国 CHN string
Nationality 国家地区代码 CHN string
Warn 告警码(-9103 证照翻拍告警;-9102 证照复印件告警;-9106 证件遮挡告警) [] string
AdvancedInfo 扩展字段 {"CodeSet":{"Confidence":"0.9999"},"GivenName":{"Confidence":"0.9999"}} string
CodeSet 最下方第一行MRZCode序列 POCHNLIUHAIMING string
CodeCrc 最下方第二行MRZCode序列 C109653787CHN6004240M3308235MBPFLKKDMD00000 string
Surname LIU string
GivenName SAN string
PassportRecognizeInfos 信息区证件内容 {"DateOfBirth":"24 APR 1960","Sex":"男/M","PassportID":"EL0965000","IssuePlace":"上海/SHANGHAI"} string
DateOfIssuance 发行日期(护照信息页识别结果) 24 8月/AUG 2023 string
IssuePlace 签发地点(护照信息页识别结果,仅中国大陆护照返回) 上海/SHANGHAI string
IssuingAuthority 签发机关(护照信息页识别结果,仅中国大陆护照返回) 中华人民共和国国家移民管理局National Immigration Administration,PRC string
PassportID 护照号码(护照信息页识别结果) EL0965000 string
Signature 持证人签名(护照信息页识别结果,仅中国大陆护照返回) 张三 string
Type 证件类型(护照信息页识别结果) PO string

6、响应状态码说明

code msg
0 未知错误
1 提交失败
2 提交成功
400 非法ip访问
401 帐号不能为空
402 密码不能为空
403 应用不存在
405 API ID 或 API KEY 不正确
4050 账号被冻结
40501 动态密码已过期
40502 动态密码校验失败
40505 没有签定合同
4051 剩余条数不足
4052 访问 ip 与备案 ip 不符
4086 通道无效
4010 通道错误
4201 查询失败
4202 图片识别失败
4301 img_file、img_url不能同时为空
4302 上传图片大小必须控制在5KB-1MB之间
4303 上传图片格式不正确,只支持bmp,jpg,jpeg,png
4304 上传图片失败

7、GET传参示例

https://api.ihuyi.com/ocr/passportintl/Submit.json?account=xxxxxxxx&password=xxxxxxxxx&img_file=&img_url=&time=1623643787

8、响应示例

示例(成功)

<?xml version="1.0" encoding="utf-8"?><SubmitResult><code>2</code><msg>提交成功</msg><idcardid>16236437872836</idcardid><result><info><list><ID>C10965000</ID><Name>ZHANG SAN</Name><DateOfBirth>19600424</DateOfBirth><Sex>M</Sex><DateOfExpiration>20330823</DateOfExpiration><IssuingCountry>CHN</IssuingCountry><Nationality>CHN</Nationality><Warn>[]</Warn><AdvancedInfo>{"CodeSet":{"Confidence":"0.9999"},"GivenName":{"Confidence":"0.9999"}}</AdvancedInfo><CodeSet>POCHNLIUHAIMING</CodeSet><CodeCrc>C109653787CHN6004240M3308235MBPFLKKDMD00000</CodeCrc><Surname>LIU</Surname><GivenName>SAN</GivenName><PassportRecognizeInfos>{"DateOfBirth":"24 APR 1960","Sex":"男/M","PassportID":"EL0965000","IssuePlace":"上海/SHANGHAI"}</PassportRecognizeInfos><DateOfIssuance>24 8月/AUG 2023</DateOfIssuance><IssuePlace>上海/SHANGHAI</IssuePlace><IssuingAuthority>中华人民共和国国家移民管理局National Immigration Administration,PRC</IssuingAuthority><PassportID>EL0965000</PassportID><Signature>张三</Signature><Type>PO</Type></list><list><ID>C10965000</ID><Name>ZHANG SAN</Name><DateOfBirth>19600424</DateOfBirth><Sex>M</Sex><DateOfExpiration>20330823</DateOfExpiration><IssuingCountry>CHN</IssuingCountry><Nationality>CHN</Nationality><Warn>[]</Warn><AdvancedInfo>{"CodeSet":{"Confidence":"0.9999"},"GivenName":{"Confidence":"0.9999"}}</AdvancedInfo><CodeSet>POCHNLIUHAIMING</CodeSet><CodeCrc>C109653787CHN6004240M3308235MBPFLKKDMD00000</CodeCrc><Surname>LIU</Surname><GivenName>SAN</GivenName><PassportRecognizeInfos>{"DateOfBirth":"24 APR 1960","Sex":"男/M","PassportID":"EL0965000","IssuePlace":"上海/SHANGHAI"}</PassportRecognizeInfos><DateOfIssuance>24 8月/AUG 2023</DateOfIssuance><IssuePlace>上海/SHANGHAI</IssuePlace><IssuingAuthority>中华人民共和国国家移民管理局National Immigration Administration,PRC</IssuingAuthority><PassportID>EL0965000</PassportID><Signature>张三</Signature><Type>PO</Type></list><list><ID>C10965000</ID><Name>ZHANG SAN</Name><DateOfBirth>19600424</DateOfBirth><Sex>M</Sex><DateOfExpiration>20330823</DateOfExpiration><IssuingCountry>CHN</IssuingCountry><Nationality>CHN</Nationality><Warn>[]</Warn><AdvancedInfo>{"CodeSet":{"Confidence":"0.9999"},"GivenName":{"Confidence":"0.9999"}}</AdvancedInfo><CodeSet>POCHNLIUHAIMING</CodeSet><CodeCrc>C109653787CHN6004240M3308235MBPFLKKDMD00000</CodeCrc><Surname>LIU</Surname><GivenName>SAN</GivenName><PassportRecognizeInfos>{"DateOfBirth":"24 APR 1960","Sex":"男/M","PassportID":"EL0965000","IssuePlace":"上海/SHANGHAI"}</PassportRecognizeInfos><DateOfIssuance>24 8月/AUG 2023</DateOfIssuance><IssuePlace>上海/SHANGHAI</IssuePlace><IssuingAuthority>中华人民共和国国家移民管理局National Immigration Administration,PRC</IssuingAuthority><PassportID>EL0965000</PassportID><Signature>张三</Signature><Type>PO</Type></list></info></result></SubmitResult>
{    "code":
            2
        ,        "msg":
            "提交成功"
        ,        "idcardid":
            "16236437872836"
        ,        "result":
                {    "info":
                    [    {    "ID":
            "C10965000"
        ,        "Name":
            "ZHANG SAN"
        ,        "DateOfBirth":
            "19600424"
        ,        "Sex":
            "M"
        ,        "DateOfExpiration":
            "20330823"
        ,        "IssuingCountry":
            "CHN"
        ,        "Nationality":
            "CHN"
        ,        "Warn":
            "[]"
        ,        "AdvancedInfo":
            "{\"CodeSet\":{\"Confidence\":\"0.9999\"},\"GivenName\":{\"Confidence\":\"0.9999\"}}"
        ,        "CodeSet":
            "POCHNLIUHAIMING"
        ,        "CodeCrc":
            "C109653787CHN6004240M3308235MBPFLKKDMD00000"
        ,        "Surname":
            "LIU"
        ,        "GivenName":
            "SAN"
        ,        "PassportRecognizeInfos":
            "{\"DateOfBirth\":\"24 APR 1960\",\"Sex\":\"男/M\",\"PassportID\":\"EL0965000\",\"IssuePlace\":\"上海/SHANGHAI\"}"
        ,        "DateOfIssuance":
            "24 8月/AUG 2023"
        ,        "IssuePlace":
            "上海/SHANGHAI"
        ,        "IssuingAuthority":
            "中华人民共和国国家移民管理局National Immigration Administration,PRC"
        ,        "PassportID":
            "EL0965000"
        ,        "Signature":
            "张三"
        ,        "Type":
            "PO"
                }
    ,        {    "ID":
            "C10965000"
        ,        "Name":
            "ZHANG SAN"
        ,        "DateOfBirth":
            "19600424"
        ,        "Sex":
            "M"
        ,        "DateOfExpiration":
            "20330823"
        ,        "IssuingCountry":
            "CHN"
        ,        "Nationality":
            "CHN"
        ,        "Warn":
            "[]"
        ,        "AdvancedInfo":
            "{\"CodeSet\":{\"Confidence\":\"0.9999\"},\"GivenName\":{\"Confidence\":\"0.9999\"}}"
        ,        "CodeSet":
            "POCHNLIUHAIMING"
        ,        "CodeCrc":
            "C109653787CHN6004240M3308235MBPFLKKDMD00000"
        ,        "Surname":
            "LIU"
        ,        "GivenName":
            "SAN"
        ,        "PassportRecognizeInfos":
            "{\"DateOfBirth\":\"24 APR 1960\",\"Sex\":\"男/M\",\"PassportID\":\"EL0965000\",\"IssuePlace\":\"上海/SHANGHAI\"}"
        ,        "DateOfIssuance":
            "24 8月/AUG 2023"
        ,        "IssuePlace":
            "上海/SHANGHAI"
        ,        "IssuingAuthority":
            "中华人民共和国国家移民管理局National Immigration Administration,PRC"
        ,        "PassportID":
            "EL0965000"
        ,        "Signature":
            "张三"
        ,        "Type":
            "PO"
                }
    ,        {    "ID":
            "C10965000"
        ,        "Name":
            "ZHANG SAN"
        ,        "DateOfBirth":
            "19600424"
        ,        "Sex":
            "M"
        ,        "DateOfExpiration":
            "20330823"
        ,        "IssuingCountry":
            "CHN"
        ,        "Nationality":
            "CHN"
        ,        "Warn":
            "[]"
        ,        "AdvancedInfo":
            "{\"CodeSet\":{\"Confidence\":\"0.9999\"},\"GivenName\":{\"Confidence\":\"0.9999\"}}"
        ,        "CodeSet":
            "POCHNLIUHAIMING"
        ,        "CodeCrc":
            "C109653787CHN6004240M3308235MBPFLKKDMD00000"
        ,        "Surname":
            "LIU"
        ,        "GivenName":
            "SAN"
        ,        "PassportRecognizeInfos":
            "{\"DateOfBirth\":\"24 APR 1960\",\"Sex\":\"男/M\",\"PassportID\":\"EL0965000\",\"IssuePlace\":\"上海/SHANGHAI\"}"
        ,        "DateOfIssuance":
            "24 8月/AUG 2023"
        ,        "IssuePlace":
            "上海/SHANGHAI"
        ,        "IssuingAuthority":
            "中华人民共和国国家移民管理局National Immigration Administration,PRC"
        ,        "PassportID":
            "EL0965000"
        ,        "Signature":
            "张三"
        ,        "Type":
            "PO"
                }
        ]
            }
                }

示例(失败)

<?xml version="1.0" encoding="utf-8"?><SubmitResult><code>1</code><msg>提交失败</msg></SubmitResult>
{"code":1,"msg":"提交失败"}

9、PHP生成动态密码方式代码示例

$account = 'xxxxxxxx';
$password = 'xxxxxxxxx';
$app = 'passportintl'; //固定值
$time = '1623643787';
$password=md5($account.$password.$app.$time);
$password=md5('xxxxxxxxxxxxxxxxxpassportintl1623643787');

//注意:所有字符编码统一为UTF-8

10、代码示例

在线咨询
服务热线:
4008 808 898

免费体验

提交成功
若短信发送异常,系统将自动给您发送语音验证码,请注意接听电话。

填写验证码后,点击“开通体验账户”自动开通体验账户。

收不到短信验证码?
×