中国护照识别
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | RecognizeChinesePassport |
系统规定参数。取值：RecognizeChinesePassport。 |
| Url | String | 否 | https://img.alicdn.com/imgextra/i2/O1CN01yaQKCT1PrUsTWqgSK_!!6000000001894-0-tps-271-186.jpg |
图片链接（长度不超 2048，不支持 base64） |
| String | 否 | 图片二进制 |
图片二进制字节流，最大10MB |
|
| OutputFigure | Boolean | 否 | true |
是否需要图案检测功能，默认需要 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | 43A29C77-405E-4CC0-BC55-EE694AD00655 |
请求唯一 ID |
| Data | String | {"data":{"passportType":"P","countryCode":"CHN","passportNumber":"E90000082","nameEn":",ZHENGJIANGANGUX","name":"","sex":"3.7F","birthPlace":"北京/BEIJIHG","nationality":"","issuePlace":"山东/SHANDON","issueAuthority":"公安部出入境管理局","mrzLine1":"POCHNZHENGJIAN<<YANGBEN<<<<<<<<<<<<<<<<<<<<<","mrzLine2":"E900000821CHN8108038F2110189NGKELMPONBPJB978","validToDate":"2921.DCF.3B","birthDate":"08.1981","issueDate":"91.1010.19"},"ftype":0,"height":186,"orgHeight":186,"orgWidth":271,"prism_keyValueInfo":[{"key":"passportType","keyProb":100,"value":"P","valuePos":[{"x":93,"y":26},{"x":93,"y":33},{"x":87,"y":33},{"x":87,"y":26}],"valueProb":100},{"key":"countryCode","keyProb":92,"value":"CHN","valuePos":[{"x":143,"y":26},{"x":143,"y":33},{"x":126,"y":33},{"x":126,"y":26}],"valueProb":92},{"key":"passportNumber","keyProb":100,"value":"E90000082","valuePos":[{"x":173,"y":29},{"x":230,"y":28},{"x":230,"y":35},{"x":174,"y":37}],"valueProb":100},{"key":"nameEn","keyProb":87,"value":",ZHENGJIANGANGUX","valuePos":[{"x":88,"y":55},{"x":89,"y":48},{"x":166,"y":49},{"x":166,"y":57}],"valueProb":87},{"key":"name","keyProb":100,"value":"","valueProb":100},{"key":"sex","keyProb":99,"value":"3.7F","valuePos":[{"x":103,"y":67},{"x":103,"y":74},{"x":87,"y":74},{"x":87,"y":67}],"valueProb":99},{"key":"birthPlace","keyProb":98,"value":"北京/BEIJIHG","valuePos":[{"x":133,"y":83},{"x":133,"y":91},{"x":87,"y":91},{"x":87,"y":83}],"valueProb":98},{"key":"nationality","keyProb":100,"value":"","valueProb":100},{"key":"issuePlace","keyProb":99,"value":"山东/SHANDON","valuePos":[{"x":136,"y":100},{"x":136,"y":108},{"x":88,"y":108},{"x":88,"y":100}],"valueProb":99},{"key":"issueAuthority","keyProb":79,"value":"公安部出入境管理局","valuePos":[{"x":87,"y":118},{"x":142,"y":118},{"x":142,"y":125},{"x":87,"y":125}],"valueProb":79},{"key":"mrzLine1","keyProb":100,"value":"POCHNZHENGJIAN<<YANGBEN<<<<<<<<<<<<<<<<<<<<<","valuePos":[{"x":12,"y":153},{"x":252,"y":152},{"x":252,"y":159},{"x":12,"y":161}],"valueProb":100},{"key":"mrzLine2","keyProb":99,"value":"E900000821CHN8108038F2110189NGKELMPONBPJB978","valuePos":[{"x":11,"y":166},{"x":253,"y":165},{"x":253,"y":173},{"x":12,"y":175}],"valueProb":99},{"key":"validToDate","keyProb":60,"value":"2921.DCF.3B","valuePos":[{"x":170,"y":107},{"x":171,"y":99},{"x":226,"y":101},{"x":225,"y":108}],"valueProb":86},{"key":"birthDate","keyProb":100,"value":"08.1981","valuePos":[{"x":209,"y":67},{"x":209,"y":74},{"x":181,"y":74},{"x":181,"y":67}],"valueProb":99},{"key":"issueDate","keyProb":82,"value":"91.1010.19","valuePos":[{"x":226,"y":83},{"x":226,"y":90},{"x":170,"y":90},{"x":170,"y":83}],"valueProb":84}],"sliceRect":{"x0":1,"y0":1,"x1":269,"y1":1,"x2":269,"y2":184,"x3":1,"y3":183},"width":271} |
返回数据 |
| Code | String | noPermission |
错误码 |
| Message | String | You are not authorized to perform this operation. |
错误提示 |
示例
请求示例
http(s)://[Endpoint]/?Action=RecognizeChinesePassport
&Url=https://img.alicdn.com/imgextra/i2/O1CN01yaQKCT1PrUsTWqgSK_!!6000000001894-0-tps-271-186.jpg
&body=图片二进制
&OutputFigure=true
&公共请求参数正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<RecognizeChinesePassportResponse>
<RequestId>43A29C77-405E-4CC0-BC55-EE694AD00655</RequestId>
<Data>{"data":{"passportType":"P","countryCode":"CHN","passportNumber":"E90000082","nameEn":",ZHENGJIANGANGUX","name":"","sex":"3.7F","birthPlace":"北京/BEIJIHG","nationality":"","issuePlace":"山东/SHANDON","issueAuthority":"公安部出入境管理局","mrzLine1":"POCHNZHENGJIAN<<YANGBEN<<<<<<<<<<<<<<<<<<<<<","mrzLine2":"E900000821CHN8108038F2110189NGKELMPONBPJB978","validToDate":"2921.DCF.3B","birthDate":"08.1981","issueDate":"91.1010.19"},"ftype":0,"height":186,"orgHeight":186,"orgWidth":271,"prism_keyValueInfo":[{"key":"passportType","keyProb":100,"value":"P","valuePos":[{"x":93,"y":26},{"x":93,"y":33},{"x":87,"y":33},{"x":87,"y":26}],"valueProb":100},{"key":"countryCode","keyProb":92,"value":"CHN","valuePos":[{"x":143,"y":26},{"x":143,"y":33},{"x":126,"y":33},{"x":126,"y":26}],"valueProb":92},{"key":"passportNumber","keyProb":100,"value":"E90000082","valuePos":[{"x":173,"y":29},{"x":230,"y":28},{"x":230,"y":35},{"x":174,"y":37}],"valueProb":100},{"key":"nameEn","keyProb":87,"value":",ZHENGJIANGANGUX","valuePos":[{"x":88,"y":55},{"x":89,"y":48},{"x":166,"y":49},{"x":166,"y":57}],"valueProb":87},{"key":"name","keyProb":100,"value":"","valueProb":100},{"key":"sex","keyProb":99,"value":"3.7F","valuePos":[{"x":103,"y":67},{"x":103,"y":74},{"x":87,"y":74},{"x":87,"y":67}],"valueProb":99},{"key":"birthPlace","keyProb":98,"value":"北京/BEIJIHG","valuePos":[{"x":133,"y":83},{"x":133,"y":91},{"x":87,"y":91},{"x":87,"y":83}],"valueProb":98},{"key":"nationality","keyProb":100,"value":"","valueProb":100},{"key":"issuePlace","keyProb":99,"value":"山东/SHANDON","valuePos":[{"x":136,"y":100},{"x":136,"y":108},{"x":88,"y":108},{"x":88,"y":100}],"valueProb":99},{"key":"issueAuthority","keyProb":79,"value":"公安部出入境管理局","valuePos":[{"x":87,"y":118},{"x":142,"y":118},{"x":142,"y":125},{"x":87,"y":125}],"valueProb":79},{"key":"mrzLine1","keyProb":100,"value":"POCHNZHENGJIAN<<YANGBEN<<<<<<<<<<<<<<<<<<<<<","valuePos":[{"x":12,"y":153},{"x":252,"y":152},{"x":252,"y":159},{"x":12,"y":161}],"valueProb":100},{"key":"mrzLine2","keyProb":99,"value":"E900000821CHN8108038F2110189NGKELMPONBPJB978","valuePos":[{"x":11,"y":166},{"x":253,"y":165},{"x":253,"y":173},{"x":12,"y":175}],"valueProb":99},{"key":"validToDate","keyProb":60,"value":"2921.DCF.3B","valuePos":[{"x":170,"y":107},{"x":171,"y":99},{"x":226,"y":101},{"x":225,"y":108}],"valueProb":86},{"key":"birthDate","keyProb":100,"value":"08.1981","valuePos":[{"x":209,"y":67},{"x":209,"y":74},{"x":181,"y":74},{"x":181,"y":67}],"valueProb":99},{"key":"issueDate","keyProb":82,"value":"91.1010.19","valuePos":[{"x":226,"y":83},{"x":226,"y":90},{"x":170,"y":90},{"x":170,"y":83}],"valueProb":84}],"sliceRect":{"x0":1,"y0":1,"x1":269,"y1":1,"x2":269,"y2":184,"x3":1,"y3":183},"width":271}</Data>
</RecognizeChinesePassportResponse>JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "43A29C77-405E-4CC0-BC55-EE694AD00655",
"Data" : "{\"data\":{\"passportType\":\"P\",\"countryCode\":\"CHN\",\"passportNumber\":\"E90000082\",\"nameEn\":\",ZHENGJIANGANGUX\",\"name\":\"\",\"sex\":\"3.7F\",\"birthPlace\":\"北京/BEIJIHG\",\"nationality\":\"\",\"issuePlace\":\"山东/SHANDON\",\"issueAuthority\":\"公安部出入境管理局\",\"mrzLine1\":\"POCHNZHENGJIAN<<YANGBEN<<<<<<<<<<<<<<<<<<<<<\",\"mrzLine2\":\"E900000821CHN8108038F2110189NGKELMPONBPJB978\",\"validToDate\":\"2921.DCF.3B\",\"birthDate\":\"08.1981\",\"issueDate\":\"91.1010.19\"},\"ftype\":0,\"height\":186,\"orgHeight\":186,\"orgWidth\":271,\"prism_keyValueInfo\":[{\"key\":\"passportType\",\"keyProb\":100,\"value\":\"P\",\"valuePos\":[{\"x\":93,\"y\":26},{\"x\":93,\"y\":33},{\"x\":87,\"y\":33},{\"x\":87,\"y\":26}],\"valueProb\":100},{\"key\":\"countryCode\",\"keyProb\":92,\"value\":\"CHN\",\"valuePos\":[{\"x\":143,\"y\":26},{\"x\":143,\"y\":33},{\"x\":126,\"y\":33},{\"x\":126,\"y\":26}],\"valueProb\":92},{\"key\":\"passportNumber\",\"keyProb\":100,\"value\":\"E90000082\",\"valuePos\":[{\"x\":173,\"y\":29},{\"x\":230,\"y\":28},{\"x\":230,\"y\":35},{\"x\":174,\"y\":37}],\"valueProb\":100},{\"key\":\"nameEn\",\"keyProb\":87,\"value\":\",ZHENGJIANGANGUX\",\"valuePos\":[{\"x\":88,\"y\":55},{\"x\":89,\"y\":48},{\"x\":166,\"y\":49},{\"x\":166,\"y\":57}],\"valueProb\":87},{\"key\":\"name\",\"keyProb\":100,\"value\":\"\",\"valueProb\":100},{\"key\":\"sex\",\"keyProb\":99,\"value\":\"3.7F\",\"valuePos\":[{\"x\":103,\"y\":67},{\"x\":103,\"y\":74},{\"x\":87,\"y\":74},{\"x\":87,\"y\":67}],\"valueProb\":99},{\"key\":\"birthPlace\",\"keyProb\":98,\"value\":\"北京/BEIJIHG\",\"valuePos\":[{\"x\":133,\"y\":83},{\"x\":133,\"y\":91},{\"x\":87,\"y\":91},{\"x\":87,\"y\":83}],\"valueProb\":98},{\"key\":\"nationality\",\"keyProb\":100,\"value\":\"\",\"valueProb\":100},{\"key\":\"issuePlace\",\"keyProb\":99,\"value\":\"山东/SHANDON\",\"valuePos\":[{\"x\":136,\"y\":100},{\"x\":136,\"y\":108},{\"x\":88,\"y\":108},{\"x\":88,\"y\":100}],\"valueProb\":99},{\"key\":\"issueAuthority\",\"keyProb\":79,\"value\":\"公安部出入境管理局\",\"valuePos\":[{\"x\":87,\"y\":118},{\"x\":142,\"y\":118},{\"x\":142,\"y\":125},{\"x\":87,\"y\":125}],\"valueProb\":79},{\"key\":\"mrzLine1\",\"keyProb\":100,\"value\":\"POCHNZHENGJIAN<<YANGBEN<<<<<<<<<<<<<<<<<<<<<\",\"valuePos\":[{\"x\":12,\"y\":153},{\"x\":252,\"y\":152},{\"x\":252,\"y\":159},{\"x\":12,\"y\":161}],\"valueProb\":100},{\"key\":\"mrzLine2\",\"keyProb\":99,\"value\":\"E900000821CHN8108038F2110189NGKELMPONBPJB978\",\"valuePos\":[{\"x\":11,\"y\":166},{\"x\":253,\"y\":165},{\"x\":253,\"y\":173},{\"x\":12,\"y\":175}],\"valueProb\":99},{\"key\":\"validToDate\",\"keyProb\":60,\"value\":\"2921.DCF.3B\",\"valuePos\":[{\"x\":170,\"y\":107},{\"x\":171,\"y\":99},{\"x\":226,\"y\":101},{\"x\":225,\"y\":108}],\"valueProb\":86},{\"key\":\"birthDate\",\"keyProb\":100,\"value\":\"08.1981\",\"valuePos\":[{\"x\":209,\"y\":67},{\"x\":209,\"y\":74},{\"x\":181,\"y\":74},{\"x\":181,\"y\":67}],\"valueProb\":99},{\"key\":\"issueDate\",\"keyProb\":82,\"value\":\"91.1010.19\",\"valuePos\":[{\"x\":226,\"y\":83},{\"x\":226,\"y\":90},{\"x\":170,\"y\":90},{\"x\":170,\"y\":83}],\"valueProb\":84}],\"sliceRect\":{\"x0\":1,\"y0\":1,\"x1\":269,\"y1\":1,\"x2\":269,\"y2\":184,\"x3\":1,\"y3\":183},\"width\":271}"
}返回示例补充说明
返回数据说明
passportType 证件类型
countryCode 国家码
passportNumber 护照号码
nameEn 英文姓名
name 中文姓名
sex 性别
birthPlace 出生地
nationality 国籍
issuePlace 签发地
issueAuthority 签发机关
mrzLine1 机读码一
mrzLine2 机读码二
validToDate 有效期至
birthDate 出生日期
issueDate 签发日期
angle 角度：0-360，0表示向上，90表示向右，180表示向下，270度表示向左
height 算法矫正图片后的高度
width 算法矫正图片后的宽度
orgHeight 原图的高度
orgWidth 原图的宽度
----------------------------------------prism_keyValueInfo文字块数组内的字段说明---------------------------------------
valuePos 外矩形四个点的坐标按顺时针排列，左上、右上、右下、左下错误码
访问错误中心查看更多错误码。