国际护照识别
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | RecognizePassport |
系统规定参数。取值：RecognizePassport。 |
| Url | String | 否 | https://img.alicdn.com/tfs/TB1uHglUgHqK1RjSZFEXXcGMXXa-800-502.png |
图片链接（长度不超 2048，不支持 base64） |
| String | 否 | 图片二进制文件 |
图片二进制文件，最大10MB，与URL二选一。 使用HTTP方式调用，把图片二进制文件放到HTTP body 中上传即可。 使用SDK的方式调用，把图片放到SDK的body中即可。 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | 43A29C77-405E-4CC0-BC55-EE694AD00655 |
请求唯一 ID |
| Data | String | { "data": { "mrzLine1": "P<ISRTOLEDANO<<RIVKA<<<<<<<<<<<<<<<<<<<<<<<<", "mrzLine2": "31526354<1ISR8804042F22080623<0473432<1<<<50", "nationality": "ISR", "surname": "TOLEDANO", "givenName": "RIVKA", "passportNumber": "31526354", "birthDate": "880404", "birthDateYmd": "1988年04月04日", "sex": "Female", "validToDate": "2022年08月06日" }, "height": 502, "orgHeight": 502, "orgWidth": 800, "prism_keyValueInfo": [{ "key": "mrzLine1", "keyProb": 99, "value": "P<ISRTOLEDANO<<RIVKA<<<<<<<<<<<<<<<<<<<<<<<<", "valuePos": [{ "x": 78, "y": 396 }, { "x": 715, "y": 391 }, { "x": 716, "y": 407 }, { "x": 79, "y": 412 }], "valueProb": 99 }, { "key": "mrzLine2", "keyProb": 100, "value": "31526354<1ISR8804042F22080623<0473432<1<<<50", "valuePos": [{ "x": 77, "y": 429 }, { "x": 715, "y": 425 }, { "x": 716, "y": 440 }, { "x": 78, "y": 445 }], "valueProb": 100 }, { "key": "nationality", "keyProb": 99, "value": "ISR", "valuePos": [{ "x": 78, "y": 396 }, { "x": 715, "y": 391 }, { "x": 716, "y": 407 }, { "x": 79, "y": 412 }], "valueProb": 99 }, { "key": "surname", "keyProb": 99, "value": "TOLEDANO", "valuePos": [{ "x": 78, "y": 396 }, { "x": 715, "y": 391 }, { "x": 716, "y": 407 }, { "x": 79, "y": 412 }], "valueProb": 99 }, { "key": "givenName", "keyProb": 99, "value": "RIVKA", "valuePos": [{ "x": 78, "y": 396 }, { "x": 715, "y": 391 }, { "x": 716, "y": 407 }, { "x": 79, "y": 412 }], "valueProb": 99 }, { "key": "passportNumber", "keyProb": 100, "value": "31526354", "valuePos": [{ "x": 77, "y": 429 }, { "x": 715, "y": 425 }, { "x": 716, "y": 440 }, { "x": 78, "y": 445 }], "valueProb": 100 }, { "key": "birthDate", "keyProb": 100, "value": "880404", "valuePos": [{ "x": 77, "y": 429 }, { "x": 715, "y": 425 }, { "x": 716, "y": 440 }, { "x": 78, "y": 445 }], "valueProb": 100 }, { "key": "birthDateYmd", "keyProb": 100, "value": "1988年04月04日", "valuePos": [{ "x": 77, "y": 429 }, { "x": 715, "y": 425 }, { "x": 716, "y": 440 }, { "x": 78, "y": 445 }], "valueProb": 100 }, { "key": "sex", "keyProb": 100, "value": "Female", "valuePos": [{ "x": 77, "y": 429 }, { "x": 715, "y": 425 }, { "x": 716, "y": 440 }, { "x": 78, "y": 445 }], "valueProb": 100 }, { "key": "validToDate", "keyProb": 100, "value": "2022年08月06日", "valuePos": [{ "x": 77, "y": 429 }, { "x": 715, "y": 425 }, { "x": 716, "y": 440 }, { "x": 78, "y": 445 }], "valueProb": 100 }], "width": 800 } |
返回数据 |
| Code | String | 200 |
状态码 |
| Message | String | message |
详细信息 |
示例
请求示例
http(s)://[Endpoint]/?Action=RecognizePassport
&Url=https://img.alicdn.com/tfs/TB1Wo7eXAvoK1RjSZFDXXXY3pXa-2512-3509.jpg
&公共请求参数正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<RecognizePassportResponse>
<RequestId>AC94ED45-9CB4-42F3-9F89-42B51A46B2CD</RequestId>
<Data>{"data":{"mrzLine1":"P<ISRTOLEDANO<<RIVKA<<<<<<<<<<<<<<<<<<<<<<<<","mrzLine2":"31526354<1ISR8804042F22080623<0473432<1<<<50","nationality":"ISR","surname":"TOLEDANO","givenName":"RIVKA","passportNumber":"31526354","birthDate":"880404","birthDateYmd":"1988年04月04日","sex":"Female","validToDate":"2022年08月06日"},"height":502,"orgHeight":502,"orgWidth":800,"prism_keyValueInfo":[{"key":"mrzLine1","keyProb":99,"value":"P<ISRTOLEDANO<<RIVKA<<<<<<<<<<<<<<<<<<<<<<<<","valuePos":[{"x":78,"y":396},{"x":715,"y":391},{"x":716,"y":407},{"x":79,"y":412}],"valueProb":99},{"key":"mrzLine2","keyProb":100,"value":"31526354<1ISR8804042F22080623<0473432<1<<<50","valuePos":[{"x":77,"y":429},{"x":715,"y":425},{"x":716,"y":440},{"x":78,"y":445}],"valueProb":100},{"key":"nationality","keyProb":99,"value":"ISR","valuePos":[{"x":78,"y":396},{"x":715,"y":391},{"x":716,"y":407},{"x":79,"y":412}],"valueProb":99},{"key":"surname","keyProb":99,"value":"TOLEDANO","valuePos":[{"x":78,"y":396},{"x":715,"y":391},{"x":716,"y":407},{"x":79,"y":412}],"valueProb":99},{"key":"givenName","keyProb":99,"value":"RIVKA","valuePos":[{"x":78,"y":396},{"x":715,"y":391},{"x":716,"y":407},{"x":79,"y":412}],"valueProb":99},{"key":"passportNumber","keyProb":100,"value":"31526354","valuePos":[{"x":77,"y":429},{"x":715,"y":425},{"x":716,"y":440},{"x":78,"y":445}],"valueProb":100},{"key":"birthDate","keyProb":100,"value":"880404","valuePos":[{"x":77,"y":429},{"x":715,"y":425},{"x":716,"y":440},{"x":78,"y":445}],"valueProb":100},{"key":"birthDateYmd","keyProb":100,"value":"1988年04月04日","valuePos":[{"x":77,"y":429},{"x":715,"y":425},{"x":716,"y":440},{"x":78,"y":445}],"valueProb":100},{"key":"sex","keyProb":100,"value":"Female","valuePos":[{"x":77,"y":429},{"x":715,"y":425},{"x":716,"y":440},{"x":78,"y":445}],"valueProb":100},{"key":"validToDate","keyProb":100,"value":"2022年08月06日","valuePos":[{"x":77,"y":429},{"x":715,"y":425},{"x":716,"y":440},{"x":78,"y":445}],"valueProb":100}],"width":800}</Data>
</RecognizePassportResponse>JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "AC94ED45-9CB4-42F3-9F89-42B51A46B2CD",
"Data" : "{\"data\":{\"mrzLine1\":\"P<ISRTOLEDANO<<RIVKA<<<<<<<<<<<<<<<<<<<<<<<<\",\"mrzLine2\":\"31526354<1ISR8804042F22080623<0473432<1<<<50\",\"nationality\":\"ISR\",\"surname\":\"TOLEDANO\",\"givenName\":\"RIVKA\",\"passportNumber\":\"31526354\",\"birthDate\":\"880404\",\"birthDateYmd\":\"1988年04月04日\",\"sex\":\"Female\",\"validToDate\":\"2022年08月06日\"},\"height\":502,\"orgHeight\":502,\"orgWidth\":800,\"prism_keyValueInfo\":[{\"key\":\"mrzLine1\",\"keyProb\":99,\"value\":\"P<ISRTOLEDANO<<RIVKA<<<<<<<<<<<<<<<<<<<<<<<<\",\"valuePos\":[{\"x\":78,\"y\":396},{\"x\":715,\"y\":391},{\"x\":716,\"y\":407},{\"x\":79,\"y\":412}],\"valueProb\":99},{\"key\":\"mrzLine2\",\"keyProb\":100,\"value\":\"31526354<1ISR8804042F22080623<0473432<1<<<50\",\"valuePos\":[{\"x\":77,\"y\":429},{\"x\":715,\"y\":425},{\"x\":716,\"y\":440},{\"x\":78,\"y\":445}],\"valueProb\":100},{\"key\":\"nationality\",\"keyProb\":99,\"value\":\"ISR\",\"valuePos\":[{\"x\":78,\"y\":396},{\"x\":715,\"y\":391},{\"x\":716,\"y\":407},{\"x\":79,\"y\":412}],\"valueProb\":99},{\"key\":\"surname\",\"keyProb\":99,\"value\":\"TOLEDANO\",\"valuePos\":[{\"x\":78,\"y\":396},{\"x\":715,\"y\":391},{\"x\":716,\"y\":407},{\"x\":79,\"y\":412}],\"valueProb\":99},{\"key\":\"givenName\",\"keyProb\":99,\"value\":\"RIVKA\",\"valuePos\":[{\"x\":78,\"y\":396},{\"x\":715,\"y\":391},{\"x\":716,\"y\":407},{\"x\":79,\"y\":412}],\"valueProb\":99},{\"key\":\"passportNumber\",\"keyProb\":100,\"value\":\"31526354\",\"valuePos\":[{\"x\":77,\"y\":429},{\"x\":715,\"y\":425},{\"x\":716,\"y\":440},{\"x\":78,\"y\":445}],\"valueProb\":100},{\"key\":\"birthDate\",\"keyProb\":100,\"value\":\"880404\",\"valuePos\":[{\"x\":77,\"y\":429},{\"x\":715,\"y\":425},{\"x\":716,\"y\":440},{\"x\":78,\"y\":445}],\"valueProb\":100},{\"key\":\"birthDateYmd\",\"keyProb\":100,\"value\":\"1988年04月04日\",\"valuePos\":[{\"x\":77,\"y\":429},{\"x\":715,\"y\":425},{\"x\":716,\"y\":440},{\"x\":78,\"y\":445}],\"valueProb\":100},{\"key\":\"sex\",\"keyProb\":100,\"value\":\"Female\",\"valuePos\":[{\"x\":77,\"y\":429},{\"x\":715,\"y\":425},{\"x\":716,\"y\":440},{\"x\":78,\"y\":445}],\"valueProb\":100},{\"key\":\"validToDate\",\"keyProb\":100,\"value\":\"2022年08月06日\",\"valuePos\":[{\"x\":77,\"y\":429},{\"x\":715,\"y\":425},{\"x\":716,\"y\":440},{\"x\":78,\"y\":445}],\"valueProb\":100}],\"width\":800}"
}返回示例补充说明
中英文字段映射
mrzLine1 第一行
mrzLine2 第二行
nationality 国籍
surname 姓
givenName 名
passportNumber 护照号
birthDate 出生日期
birthDateYmd 出生日期-年月日
sex 性别
validToDate 护照有效期错误码
访问错误中心查看更多错误码。