提交查询
https://api.ihuyi.com/ocr/passportintl/Submit.json
| 参数名称 | 参数值描述 | 示例 | 类型 | 必填 |
| Content-Type | 内容类型,固定值 | application/x-www-form-urlencoded | string | 是 |
| 参数名称 | 参数值描述 | 示例 | 类型 | 必填 |
| 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 | 否 |
| 参数名称 | 参数值描述 | 示例 | 类型 | 必返 |
| 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 | 签发机关(护照信息页识别结果,仅中国大陆护照返回) | 中华人民共和国国家移民管理局 |
string | |
| PassportID | 护照号码(护照信息页识别结果) | EL0965000 | string | |
| Signature | 持证人签名(护照信息页识别结果,仅中国大陆护照返回) | 张三 | string | |
| Type | 证件类型(护照信息页识别结果) | PO | string |
| 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 | 上传图片失败 |
https://api.ihuyi.com/ocr/passportintl/Submit.json?account=xxxxxxxx&password=xxxxxxxxx&img_file=&img_url=&time=1623643787
示例(成功)
<?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":"提交失败"}
$account = 'xxxxxxxx';
$password = 'xxxxxxxxx';
$app = 'passportintl'; //固定值
$time = '1623643787';
$password=md5($account.$password.$app.$time);
$password=md5('xxxxxxxxxxxxxxxxxpassportintl1623643787');
//注意:所有字符编码统一为UTF-8
在线咨询
150,000家
企业客户
21年
行业经验
2V1
2对1客户支持