简要描述：

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

请求URL:

接口地址：https://gauss.shargoodata.com/gauss/api/idcard_api_v3.json
请求方式：POST
数据类型：form-data

请求头：

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

请求参数:

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

响应结果:

参数名 是否必须 类型 说明
success 是 boolean 是否处理成功，true:成功，false：失败；
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代表反面
身份证“国徽面”：
参数名 是否必须 类型 说明
issued_by 是 String 签发机关
valid_date 是 String 有效期
type 是 String front代表正面 back代表反面
error_code参数说明：
code码 message
501 商户不存在
400 参数不合法

“人像面”返回示例:

正确时返回:

{
    "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":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":"参数不合法"
}
文档更新时间: 2025-04-10 18:21   作者：admin