注意：

• 身份证识别接口全面升级，算法更强、性能更优，支持子账号调用。欢迎立即体验 新版身份证识别。
• 新老版本的接口计费模式相同，且共享计费阶梯和资源包，您可以在【文字识别控制台】>【用量统计】中查看调用情况。
• 老版本接口我们仍继续维护，但不支持新客户开通调用，建议您使用 新版身份证识别，体验更优服务。

接口描述

接口请求域名：https://recognition.image.myqcloud.com/ocr/idcard
本接口（idcard）用于识别身份证上的姓名、证件号、地址等信息。

说明：

本接口支持 HTTPS 协议，如果您现在使用的是 HTTP 协议，为了保障您的数据安全，请切换至 HTTPS。

请求头 header

注意：

如选择 multipart/form-data，请使用 HTTP 框架/库推荐的方式设置请求的 content-type，不推荐直接调用 setheader 等方法设置，否则可能导致 boundary 缺失引起请求失败。

使用 application/json 格式

输入参数

输出参数

result_list（ JSON 数组）中每一项的具体内容：

data 字段具体内容（身份证有照片的一面）：

data 字段具体内容（身份证反面）：

说明：

如未识别出某字段（如 name ），则该字段对应的置信度（如 name_confidence ）为-1。

示例

输入示例

POST /ocr/idcardHTTP/1.1
Authorization: FL26MsO1nhrZGuXdin10DE5tnDdhPTEwMDAwMDEmYj1xaW5pdXRlc3QyJms9QUtJRG1PNWNQVzNMREdKc2FyREVEY1ExRnByWlZDMW9wZ3FYJnQ9MTQ2OTE3NTIzMCZlPTE0NjkxNzYyMzA=
Host: recognition.image.myqcloud.com
Content-Length: 302
Content-Type: "application/json"
{
"appid":11111,
"bucket":"test",
"card_type":0,
"url_list":[
"http://www.test.com/aaa.jpg",
"http://www.test.com/bbb.jpg"
]
}

输出示例

{
"result_list": [{
    "code": 0,
    "message": "OK",
    "url": " http://www.test.com/aaa.jpg",
    "data": {
        "name": "某某",
        "sex": "男",
        "nation": "汉",
        "birth": "2000/1/1",
        "address": "某地",
        "id": "123456200001011234",
        "name_confidence_all": [
            38, 28
        ],
        "sex_confidence_all": [
            28
        ],
        "nation_confidence_all": [
            34
        ],
        "birth_confidence_all": [
            38, 38, 20, 46, 50, 49
        ],
        "address_confidence_all": [
            13, 30
        ],
        "id_confidence_all": [
            49, 50, 58, 63, 51, 52, 55, 48, 48, 47, 58, 47, 48, 56,
            45, 55, 54, 47
        ]
    }
},
{
    "code": 0,
    "message": "OK",
    "url": " http://www.test.com/bbb.jpg",
    "data": {
        "name": "某某某",
        "sex": "女",
        "nation": "汉",
        "birth": "2001/1/1",
        "address": "某地",
        "id": "123456200101011234",
        "name_confidence_all": [
            38, 28, 55
        ],
        "sex_confidence_all": [
            28
        ],
        "nation_confidence_all": [
            34
        ],
        "birth_confidence_all": [
            38, 38, 20, 46, 50, 49
        ],
        "address_confidence_all": [
            13, 30
        ],
        "id_confidence_all": [
            49, 50, 58, 63, 51, 52, 55, 48, 48, 47, 58, 47, 48, 56,
            45, 55, 54, 47
        ]
    }
}
]
}

使用 multipart/form-data 格式

输入参数

使用 multipart/form-data 格式：

输出参数

result_list（JSON 数组）中每一项的具体内容：

data 字段具体内容（身份证有照片的一面）：

说明：

如未识别出某字段（如 name），则该字段对应的置信度（如 name_confidence）为-1。

data 字段具体内容（身份证反面）：

说明：

如未识别出某字段（如 name ），则该字段对应的置信度（如 name_confidence ）为-1。

示例

输入示例

POST /ocr/idcard HTTP/1.1
Content-Type:multipart/form-data;boundary=-------------------------acebdf13572468
Authorization: FCHXddYbhZEBfTeZ0j8mn9Og16JhPTEwMDAwMzc5Jms9QUtJRGVRZDBrRU1yM2J4ZjhRckJiUkp3Sk5zbTN3V1lEeHN1JnQ9MTQ2ODQ3NDY2MiZyPTU3MiZ1PTAmYj10ZXN0YnVja2V0JmU9MTQ3MTA2NjY2Mg==
Host: recognition.image.myqcloud.com
Content-Length: 61478
---------------------------acebdf13572468
Content-Disposition: form-data; name="appid";
11111
---------------------------acebdf13572468
Content-Disposition: form-data; name="bucket";
testbucket
---------------------------acebdf13572468
Content-Disposition: form-data; name="card_type";
1
---------------------------acebdf13572468
Content-Disposition: form-data; name="image[0]"; filename="1.jpg"
Content-Type: image/jpeg
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
---------------------------acebdf13572468
Content-Disposition: form-data; name="image[1]"; filename="2.jpg"
Content-Type: image/jpeg
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
---------------------------acebdf13572468--

输出示例

{
  "result_list": [
      {
          "code": 0,
          "message": "success",
          "filename": "1.jpg",
          "data": {
              "authority": "某市派出所",
              "valid_date": "2012.01.01-2022.01.01",
              "authority_confidence_all": [
                  42, 36, 40, 49, 41
              ],
              "valid_date_confidence_all": [
                  44, 50, 63, 44, 47, 42, 43, 53, 48, 52, 44, 47, 48, 45, 50, 58
              ]
}
      },
      {
          "code": 0,
          "message": "success",
          "filename": "2.jpg",
          "data": {
              "authority": "某市派出所",
              "valid_date": "2012.01.01-2022.01.01",
              "authority_confidence_all": [
                  42, 36, 40, 49, 41
              ],
              "valid_date_confidence_all": [
                  44, 50, 63, 44, 47, 42, 43, 53, 48, 52, 44, 47, 48, 45, 50, 58
              ]
           }
      }
  ]
}

错误码

更多其他 API 错误码请查看 错误码说明。