文档中心

1、接口描述

针对新版护照图片，进行OCR检测，返回检测到的护照号码、姓名、性别等信息。本接口不适用于老版护照图片。

备注：接口只允许单张图片请求，不允许图片list。

2、请求方法

POST

3、接口要求

• 目前仅支持 base64 编码方式请求，暂不支持 url 方式请求。一次请求仅支持一条数据。
• 图片格式限制：目前仅支持 jpg、jpeg、png、bmp 等常见格式。
• 图片大小限制：图片大小不超过 7 MB。
• 图片尺寸限制：图片像素尺寸应不小于 32x32，不大于 5000x5000。

4、请求URL

/v1/aiop/api/2k8jsx0rzxmo/passport/ocr/v1/Passport.json

5、请求参数

请求头header参数

请求体body参数

6、请求代码示例

Curl -X POST
"https://ai-global.ctapi.ctyun.cn/v1/aiop/api/2k8jsx0rzxmo/passport/ocr/v1/Passport.json"
-H "Content-Type: application/json"
-H "ctyun-eop-request-id:33dfa732-b27b-464f-b15a-21ed6845afd5"
-H "appkey:XXX"
-H "Eop-Authorization:XXX"
-H "eop-date:20211109T104641Z"
-H "host:ai-global.ctapi.ctyun.cn"
--data '{"Action": "PassportOCR","ImageData": "_9j_4AAQSkZJRgA......Zuv_9k="}复制

7、返回值说明

请求成功返回响应参数

表result

请求失败返回响应参数

8、返回值示例

请求成功返回值示例

{
    "code": 0,
    "message": "success",
    "result": {
        "license_type": "New_Passport",
        "detail":
        {
            "country_code": "CHN",
            "passport_no": "EXXXX7053",
            "name": "陈XX",
            "name_pinyin": "CHEN,XXXXXXXX",
            "sex": "男/M",
            "nationality": "中国/CHINESE",
            "date_of_birth": "19XXXX01",
            "plate_of_birth": "山东/SHANDONG",
                "date_of_issue": "2013XX24",
            "plate_of_issue": "上海/SHANGHAI",
            "date_of_expiry": "2023XX23",
            "authority": "公安部出入境管理局",
            "mrzcode1": "POCHNCHEN<<XXXXXXXX<<<<<<<<<<<<<<<<<<<<<<<<<",
            "mrzcode2": "EXXXX70537CHNXXXX018M23XX235MCXXXXXX<<<<AXX0"
            }
        }
    }
}复制

请求失败返回值示例

{
    "code": 400003,
    "message": "body内容为空",
    "details": "Body 请求数据为空，没有包含内容"
}复制

9、状态码

10、错误码说明

6 位错误码。4 开头为业务错误码，5 开头为服务错误码。

11、支持的证件示例

本接口支持新版护照图片，如图所示：

本接口不适用于老版护照图片。以下图片不支持:

12、base64 编码规则：使用常规的 safe base64 编码方式

• python 中推荐使用 base64.urlsafe_b64encode() 函数进行编码。
• java 中推荐使用 BASE64.getUrlEncoder().encodeToString() 函数进行编码。