身份证五要素核验

---

接口描述

接口描述：通过传输姓名+身份证号+有效期开始时间+有效期结束时间+待比对人像照片，核验身份证信息状态、验证客户身份信息及人像照片在公安系统是否真实有效。

请求说明

HTTP 方法:

POST

请求 URL：

/ai-cloud-cweis/netCheck/checkFace/cardStatus/v2

Header如下：

参数名称	值
Content-Type	application/json;charset=UTF-8

Body中放置请求参数，参数详情如下：

请求参数：

参数名称	必填	数据类型	长度	参数描述
cId	是	String	1-32	身份证号码
cName	是	String	1-32	姓名
img	是	String	1-3000k	待处理图片(base64 编码)，原始图片大小需要小于 3M;
beginDate	是	String	8	有效期开始时间（yyyyMMdd）
endDate	是	String	8	有效期结束时间（yyyyMMdd，长期输入 00000000）
busFlowId	否	String	0-64	业务流水号，业务系统唯一序列号（对账用，建议传入）

请求示例：

{
    "busFlowId":"xxxxxxx",
    "cId":"500111200001019999",
    "cName":"钟国梦",
    "img":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQ......",
    "beginDate":"20100101", 
    "endDate":"20201231"
}

返回说明

返回参数：

返回值名称	数据类型	长度	描述
code	String	1-8	返回结果，详见返回CODE码表
message	String	1-255	返回码描述
data	Object	-	返回的数据
-checkSame	boolean	1	是否同一人
-flowId	String	1-64	交易流水ID（建议保存）
-busFlowId	String	1-64	传入的业务流水号

成功返回示例：

{
    "code":"00000000",
    "data":{
        "flowId":"xxxxxxxxxxxxxx",
        "busFlowId":"xxxxxxx",
        "checkSame":true
    },
    "message":"success"
}

错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共CODE码表

码值	是否成功	是否计费	描述
00000000	是	是	核查通过，判断为同一人
00000100	否	是	核查通过，疑似为同一人
00000101	否	是	核查通过，判断为不同人
00000102	否	是	照片质量不合格
00000103	否	是	核查通过，渠道无照片
00000200	否	是	核查失败，姓名和身份证不匹配
00000201	否	是	核查失败，未找到相关信息
00000246	否	是	身份四要素信息不一致
00000249	否	否	图片损坏
00000300	否	否	请求参数错误
00000301	否	否	系统错误，请重试
00000302	否	否	渠道调用异常
00000303	否	否	服务到期
00000304	否	否	余额不足
00000305	否	否	试用账号赠送次数已用完
00000306	否	否	渠道配置错误
00000307	否	否	图片损坏