来往大陆(内地)通行证识别
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | RecognizeExitEntryPermitToMainland |
系统规定参数。取值：RecognizeExitEntryPermitToMainland。 |
| Url | String | 否 | https://img.alicdn.com/imgextra/i2/O1CN01VpucoK1PtmovU859J_!!6000000001899-0-tps-928-626.jpg |
图片链接（长度不超 2048，不支持 base64） |
| String | 否 | 图片二进制 |
图片二进制字节流，最大10MB |
|
| OutputFigure | Boolean | 否 | true/false |
图案坐标信息输出，针对结构化，如身份证人脸头像 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | 43A29C77-405E-4CC0-BC55-EE694AD00655 |
请求唯一 ID |
| Data | String | {"data":{"permitType":"港澳居民来往内地通行证","nameCn":"何郑","nameEn":"HE,CHENG","birthDate":"2000.01.01","sex":"男","validPeriod":"2014.04.10-2019.04.09","issueAuthority":"公安部出入境管理局","issuePlace":"","permitNumber":"H10387877","issueCount":"01"},"figure":[{"type":"face","x":80,"y":164,"w":192,"h":273,"box":{"x":175,"y":300,"w":187,"h":269,"angle":0},"points":[{"x":80,"y":166},{"x":268,"y":164},{"x":270,"y":433},{"x":82,"y":435}]}],"ftype":0,"height":626,"orgHeight":626,"orgWidth":928,"prism_keyValueInfo":[{"key":"permitType","keyProb":100,"value":"港澳居民来往内地通行证","valuePos":[{"x":680,"y":41},{"x":681,"y":83},{"x":177,"y":86},{"x":176,"y":44}],"valueProb":100},{"key":"nameCn","keyProb":100,"value":"何郑","valuePos":[{"x":346,"y":119},{"x":346,"y":153},{"x":269,"y":153},{"x":269,"y":119}],"valueProb":100},{"key":"nameEn","keyProb":100,"value":"HE,CHENG","valuePos":[{"x":452,"y":166},{"x":452,"y":195},{"x":270,"y":195},{"x":270,"y":166}],"valueProb":100},{"key":"birthDate","keyProb":100,"value":"2000.01.01","valuePos":[{"x":273,"y":226},{"x":414,"y":226},{"x":414,"y":254},{"x":273,"y":254}],"valueProb":100},{"key":"sex","keyProb":100,"value":"男","valuePos":[{"x":594,"y":234},{"x":594,"y":268},{"x":562,"y":268},{"x":562,"y":234}],"valueProb":100},{"key":"validPeriod","keyProb":100,"value":"2014.04.10-2019.04.09","valuePos":[{"x":700,"y":295},{"x":700,"y":323},{"x":267,"y":324},{"x":267,"y":296}],"valueProb":100},{"key":"issueAuthority","keyProb":100,"value":"公安部出入境管理局","valuePos":[{"x":264,"y":386},{"x":265,"y":353},{"x":536,"y":357},{"x":536,"y":390}],"valueProb":100},{"key":"issuePlace","keyProb":100,"value":"","valueProb":100},{"key":"permitNumber","keyProb":100,"value":"H10387877","valuePos":[{"x":489,"y":424},{"x":489,"y":457},{"x":268,"y":457},{"x":268,"y":424}],"valueProb":100},{"key":"issueCount","keyProb":100,"value":"01","valuePos":[{"x":601,"y":425},{"x":601,"y":456},{"x":555,"y":456},{"x":555,"y":425}],"valueProb":100}],"sliceRect":{"x0":46,"y0":30,"x1":887,"y1":38,"x2":892,"y2":564,"x3":39,"y3":567},"width":928} |
返回数据 |
| Code | String | noPermission |
错误码 |
| Message | String | You are not authorized to perform this operation. |
错误提示 |
示例
请求示例
http(s)://[Endpoint]/?Action=RecognizeExitEntryPermitToMainland
&Url=https://img.alicdn.com/imgextra/i2/O1CN01VpucoK1PtmovU859J_!!6000000001899-0-tps-928-626.jpg
&body=图片二进制
&OutputFigure=false
&公共请求参数正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<RecognizeExitEntryPermitToMainlandResponse>
<RequestId>43A29C77-405E-4CC0-BC55-EE694AD00655</RequestId>
<Data>{"data":{"permitType":"港澳居民来往内地通行证","nameCn":"何郑","nameEn":"HE,CHENG","birthDate":"2000.01.01","sex":"男","validPeriod":"2014.04.10-2019.04.09","issueAuthority":"公安部出入境管理局","issuePlace":"","permitNumber":"H10387877","issueCount":"01"},"figure":[{"type":"face","x":80,"y":164,"w":192,"h":273,"box":{"x":175,"y":300,"w":187,"h":269,"angle":0},"points":[{"x":80,"y":166},{"x":268,"y":164},{"x":270,"y":433},{"x":82,"y":435}]}],"ftype":0,"height":626,"orgHeight":626,"orgWidth":928,"prism_keyValueInfo":[{"key":"permitType","keyProb":100,"value":"港澳居民来往内地通行证","valuePos":[{"x":680,"y":41},{"x":681,"y":83},{"x":177,"y":86},{"x":176,"y":44}],"valueProb":100},{"key":"nameCn","keyProb":100,"value":"何郑","valuePos":[{"x":346,"y":119},{"x":346,"y":153},{"x":269,"y":153},{"x":269,"y":119}],"valueProb":100},{"key":"nameEn","keyProb":100,"value":"HE,CHENG","valuePos":[{"x":452,"y":166},{"x":452,"y":195},{"x":270,"y":195},{"x":270,"y":166}],"valueProb":100},{"key":"birthDate","keyProb":100,"value":"2000.01.01","valuePos":[{"x":273,"y":226},{"x":414,"y":226},{"x":414,"y":254},{"x":273,"y":254}],"valueProb":100},{"key":"sex","keyProb":100,"value":"男","valuePos":[{"x":594,"y":234},{"x":594,"y":268},{"x":562,"y":268},{"x":562,"y":234}],"valueProb":100},{"key":"validPeriod","keyProb":100,"value":"2014.04.10-2019.04.09","valuePos":[{"x":700,"y":295},{"x":700,"y":323},{"x":267,"y":324},{"x":267,"y":296}],"valueProb":100},{"key":"issueAuthority","keyProb":100,"value":"公安部出入境管理局","valuePos":[{"x":264,"y":386},{"x":265,"y":353},{"x":536,"y":357},{"x":536,"y":390}],"valueProb":100},{"key":"issuePlace","keyProb":100,"value":"","valueProb":100},{"key":"permitNumber","keyProb":100,"value":"H10387877","valuePos":[{"x":489,"y":424},{"x":489,"y":457},{"x":268,"y":457},{"x":268,"y":424}],"valueProb":100},{"key":"issueCount","keyProb":100,"value":"01","valuePos":[{"x":601,"y":425},{"x":601,"y":456},{"x":555,"y":456},{"x":555,"y":425}],"valueProb":100}],"sliceRect":{"x0":46,"y0":30,"x1":887,"y1":38,"x2":892,"y2":564,"x3":39,"y3":567},"width":928}</Data>
</RecognizeExitEntryPermitToMainlandResponse>JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "43A29C77-405E-4CC0-BC55-EE694AD00655",
"Data" : "{\"data\":{\"permitType\":\"港澳居民来往内地通行证\",\"nameCn\":\"何郑\",\"nameEn\":\"HE,CHENG\",\"birthDate\":\"2000.01.01\",\"sex\":\"男\",\"validPeriod\":\"2014.04.10-2019.04.09\",\"issueAuthority\":\"公安部出入境管理局\",\"issuePlace\":\"\",\"permitNumber\":\"H10387877\",\"issueCount\":\"01\"},\"figure\":[{\"type\":\"face\",\"x\":80,\"y\":164,\"w\":192,\"h\":273,\"box\":{\"x\":175,\"y\":300,\"w\":187,\"h\":269,\"angle\":0},\"points\":[{\"x\":80,\"y\":166},{\"x\":268,\"y\":164},{\"x\":270,\"y\":433},{\"x\":82,\"y\":435}]}],\"ftype\":0,\"height\":626,\"orgHeight\":626,\"orgWidth\":928,\"prism_keyValueInfo\":[{\"key\":\"permitType\",\"keyProb\":100,\"value\":\"港澳居民来往内地通行证\",\"valuePos\":[{\"x\":680,\"y\":41},{\"x\":681,\"y\":83},{\"x\":177,\"y\":86},{\"x\":176,\"y\":44}],\"valueProb\":100},{\"key\":\"nameCn\",\"keyProb\":100,\"value\":\"何郑\",\"valuePos\":[{\"x\":346,\"y\":119},{\"x\":346,\"y\":153},{\"x\":269,\"y\":153},{\"x\":269,\"y\":119}],\"valueProb\":100},{\"key\":\"nameEn\",\"keyProb\":100,\"value\":\"HE,CHENG\",\"valuePos\":[{\"x\":452,\"y\":166},{\"x\":452,\"y\":195},{\"x\":270,\"y\":195},{\"x\":270,\"y\":166}],\"valueProb\":100},{\"key\":\"birthDate\",\"keyProb\":100,\"value\":\"2000.01.01\",\"valuePos\":[{\"x\":273,\"y\":226},{\"x\":414,\"y\":226},{\"x\":414,\"y\":254},{\"x\":273,\"y\":254}],\"valueProb\":100},{\"key\":\"sex\",\"keyProb\":100,\"value\":\"男\",\"valuePos\":[{\"x\":594,\"y\":234},{\"x\":594,\"y\":268},{\"x\":562,\"y\":268},{\"x\":562,\"y\":234}],\"valueProb\":100},{\"key\":\"validPeriod\",\"keyProb\":100,\"value\":\"2014.04.10-2019.04.09\",\"valuePos\":[{\"x\":700,\"y\":295},{\"x\":700,\"y\":323},{\"x\":267,\"y\":324},{\"x\":267,\"y\":296}],\"valueProb\":100},{\"key\":\"issueAuthority\",\"keyProb\":100,\"value\":\"公安部出入境管理局\",\"valuePos\":[{\"x\":264,\"y\":386},{\"x\":265,\"y\":353},{\"x\":536,\"y\":357},{\"x\":536,\"y\":390}],\"valueProb\":100},{\"key\":\"issuePlace\",\"keyProb\":100,\"value\":\"\",\"valueProb\":100},{\"key\":\"permitNumber\",\"keyProb\":100,\"value\":\"H10387877\",\"valuePos\":[{\"x\":489,\"y\":424},{\"x\":489,\"y\":457},{\"x\":268,\"y\":457},{\"x\":268,\"y\":424}],\"valueProb\":100},{\"key\":\"issueCount\",\"keyProb\":100,\"value\":\"01\",\"valuePos\":[{\"x\":601,\"y\":425},{\"x\":601,\"y\":456},{\"x\":555,\"y\":456},{\"x\":555,\"y\":425}],\"valueProb\":100}],\"sliceRect\":{\"x0\":46,\"y0\":30,\"x1\":887,\"y1\":38,\"x2\":892,\"y2\":564,\"x3\":39,\"y3\":567},\"width\":928}"
}返回示例补充说明
返回数据说明</br>
permitType 证件类别</br>
nameCn 中文姓名</br>
nameEn 英文姓名</br>
birthDate 出生日期</br>
sex 性别</br>
validPeriod 有效期限</br>
issueAuthority 签发机关</br>
issuePlace 签发地点</br>
permitNumber 证件号码</br>
issueCount 签发次数</br>
angle 角度：0-360，0表示向上，90表示向右，180表示向下，270度表示向左</br>
height 算法矫正图片后的高度</br>
width 算法矫正图片后的宽度</br>
orgHeight 原图的高度</br>
orgWidth 原图的宽度</br>
----------------------------------------prism_keyValueInfo文字块数组内的字段说明---------------------------------------</br>
valuePos 外矩形四个点的坐标按顺时针排列，左上、右上、右下、左下</br>
错误码
访问错误中心查看更多错误码。