简要描述：

  • 输入身份证人像面或者身份证国徽面照片，输出识别结果

请求URL:

请求方式：

  • POST

请求头：

参数名 是否必须 类型 说明
token 是 string token

请求参数:

图片要求：图片文件不超过8M；图片越小，OCR速度越快
参数名 是否必须 类型 说明
serviceName 是 string idcard_api_v3
platformNo 是 string 商户号
image 是 file 图片文件
type 是 string 0为人像面，1位国徽面
reqData 是 string 请求json字符串
reqData参数：
参数名 是否必须 类型 说明
outside_no 是 string 外部订单编号
timestamp 是 string yyyy-MM-dd-HH-mm-ss格式时间

“人像面”返回示例:

正确时返回:

{
    "success":true,
    "outside_no":"42a3345f-9355-490a-898e-15274d9b1598",
    "data":{
        "id_no":"33xxxxxxxxxxxx",
        "address":"杭州市xxxxxxxx",
        "gender":"男",
        "race":"汉",
        "name":"张三",
        "birth":"1982.09.25",
        "type":"front"
    }
}

错误时返回:

{
    "success":false,
    "outside_no":"a77acba0-a681-4f9c-8245-d14aa8119aa0",
    "error_code":"400",
    "message":"参数不合法"
}

返回参数说明:

参数名 是否必须 类型 说明
success 是 boolean 是否扣费
outside_no 是 string 外部订单编号
data 否 json 识别数据
error_code 否 string 错误代码
message 否 string 错误描述
data参数说明：
参数名 是否必须 类型 说明
id_no 是 String 身份证号
address 是 String 地址
gender 是 String 性别
race 是 String 民族
name 是 String 姓名
birth 是 String 出生日期yyyy.MM.dd
type 是 String front代表正面 back代表反面

“国徽面”返回示例:

正确时返回:

{
    "success":true,
    "outside_no":"7981c480-e998-4182-95ba-1d051f9c9f60",
    "data":{
        "issued_by":"长沙市公安局雨花分局",
        "valid_date":"2016.07.20-2026.07.20",
        "type":"back"
    }
}

错误时返回:

{
    "success":false,
    "outside_no":"a77acba0-a681-4f9c-8245-d14aa8119aa0",
    "error_code":"400",
    "message":"参数不合法"
}

返回参数说明:

参数名 是否必须 类型 说明
success 是 boolean 是否扣费
outside_no 是 string 外部订单编号
data 否 json 识别数据
error_code 否 string 错误代码
message 否 string 错误描述
data参数说明：
参数名 是否必须 类型 说明
issued_by 是 String 签发机关
valid_date 是 String 有效期
type 是 String front代表正面 back代表反面
文档更新时间: 2024-12-24 11:35   作者：admin