接口描述

針對圖片中的身份證，進行OCR檢測，返回檢測到的姓名、身份證號碼等信息。

支持識別一張圖片中有一個身份證正面或者反面的圖像，也支持識別一張圖片中有一正一反身份證圖像。

當圖片中包含兩個正面、兩個反面、三個（含）以上身份證圖像時，會選擇像素面積最大的一個身份證圖像返回識別結果。

請求方法

POST

接口要求

• 圖片格式限制：目前僅支持 jpg、jpeg、png、bmp 等常見格式
• 圖片大小限制：圖片單張大小不超過 10MB，批量請求單次不超過 5張
• 圖片尺寸限制：圖片像素尺寸應大于 32x32，小于 5000x5000

URI

/v1/aiop/api/2f3os7qq79xc/IdentityCard/ocr/v1/idcard.json

請求參數

1.請求頭header參數

2.請求體body參數

請求代碼示例

Curl -X POST
"//ai-global.ctapi.daliqc.cn/v1/aiop/api/2f3os7qq79xc/IdentityCard/ocr/v1/idcard.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.daliqc.cn"
--data '{"data":["_9j_4AAQSkZJRg..."]}'

返回值說明

1.請求成功返回響應參數

表message

表returnObj

表detail

2.請求失敗返回響應參數

表returnObj

返回值示例

1.請求成功返回值示例

{
    "statusCode": 0,
    "message": {"success" : 1, "fail" : 0},
    "returnObj": [{
        "note": "front",
        "detail": {
            "name": "",
            "sex": "",
            "nation": "",
            "birthday": "",
            "idn": "",
            "addr": "",
            "org": "蘭州市公安局城關分局",
            "validperiod": "2007.07.27-2027.07.27"
        },
        "idcard_face": "no face",
        "demo_image": "demo_image",
        "risk": "normal"
    }]
}

2.請求失敗返回值示例

示例1:
{
    "statusCode": 4004,
    "message": "error",
    "details": "data字段圖片數據不是list格式",
    "error":"AI_OP_4004"
}
示例2:處理失敗返回值示例
{
    'statusCode': 0,
    'message': {'success': 0, 'fail': 1},
    'returnObj': [{'err_code': 4008, 'err_msg': 'base64數據處理異常'}]
}

狀態碼

錯誤碼說明

4 位錯誤碼。4 開頭為業務錯誤碼，5 開頭為服務錯誤碼。全局請求返回錯誤碼請參考章節API概覽>狀態碼

base64 編碼規則：使用常規的 safe base64 編碼方式

• python 中推薦使用 base64.urlsafe_b64encode() 函數進行編碼
• java 中推薦使用 BASE64.getUrlEncoder().encodeToString() 函數進行編碼