一、3201-小文件批量上传
1. 接口功能
批量上传小文件，单个文件大小不超过2M，文件数量不超过5个。图片支持 jpg 、png格式（不支持手动修改图片后缀） 。文件存储ID（FileID）对应需调用3201的其他接口中的上传照片ID（UploadFileID）。
2. 报文结构
请求报文：
| 报文元素 | 出现要求 | 非空约束 | 数据格式 | 说明 | |
| TxCode | R | NOT NULL | N1..4 | 交易类型 | |
| InstitutionID | R | NOT NULL | ANS1..8 | 机构编号 | |
| TxSN | R | NOT NULL | ANS1..32 | 交易流水号 | |
| Files | FileName | R | NOT NULL | ANS1..256 | 文件名称 例如： img_best.jpg |
| FileContent | R | NOT NULL | ANS1.. | 文件内容 Base64 | |
| Remark | O | ANS0..256 | 备注 | ||
响应报文：
| 报文元素 | 出现要求 | 非空约束 | 数据格式 | 说明 | |
| Code | R | NOT NULL | N1..6 | 响应代码 | |
| Message | R | NOT NULL | ANS1..256 | 响应消息 | |
| TxCode | C | ANS1..4 | 交易类型 | ||
| InstitutionID | C | ANS1..8 | 机构号 | ||
| TxSN | C | ANS1..32 | 交易流水号 | ||
| TraceNo | C | ANS1..32 | 系统跟踪号 | ||
| Files | FileName | C | ANS1..256 | 文件名称 | |
| FileID | C | ANS1..32 | 文件存储ID | ||
二、2316-自拍照有源比对
1. 接口功能
上传自拍照与公安库水印照比对。需要先使用3201接口上传照片，获取到FileID，然后再使用2316接口进行比对。
上传照片要求：身份证人像面翻拍照，BASE64格式(BASE64字符串是去掉了换行符的一整行字符)。照片支持jpg，png格式，人脸朝向尽量保持正向。
压缩要求：选择对原有身份证照片尺寸做等比压缩，不要压成1:1，例如：身份证原尺寸比例是1.58:1，压缩至80，应该是（1.58:1）80%，不是（1:1）80%。建议照片处理时人像部分分辨率不低于1366768。照片整体的像素建议调整到1280760 或 680*460。
人脸识别的阈值是650，对于接近临界值的客户，会因为提供的照片人脸质量产生结果差异。上传的照片返回的得分值徘徊在数据源判断为同一人的阈值的上下。最终的结果，受提供的照片人脸质量的影响。
2. 报文结构
请求报文：
| 报文元素 | 出现要求 | 非空约束 | 数据格式 | 说明 |
|---|---|---|---|---|
| TxCode | R | NOT NULL | N1..4 | 交易类型 |
| InstitutionID | R | NOT NULL | ANS1..8 | 机构编号 |
| TxSN | R | NOT NULL | ANS1..32 | 交易流水号 |
| Name | R | NOT NULL | ANS1..50 | 姓名 |
| IdentificationNumber | R | NOT NULL | ANS1..32 | 身份证号码 |
| UploadFileID | R | NOT NULL | ANS1..32 | 上传照片ID（3201的FileID） |
| Remark | O | ANS0..256 | 备注 |
响应报文：
| 报文元素 | 出现要求 | 非空约束 | 数据格式 | 说明 |
|---|---|---|---|---|
| Code | R | NOT NULL | N1..6 | 响应代码 |
| Message | R | NOT NULL | ANS1..256 | 响应消息 |
| TxCode | C | NOT NULL | ANS1..4 | 交易类型 |
| InstitutionID | C | NOT NULL | ANS1..8 | 机构编号 |
| TxSN | C | NOT NULL | ANS1..32 | 交易流水号 |
| TraceNo | C | NOT NULL | ANS1..32 | 交易跟踪号 |
| ResponseCode | C | NOT NULL | N0..4 | 通道响应代码 |
| ResponseMessage | C | NOT NULL | ANS0..256 | 通道响应消息 |
| Verification | C | NOT NULL | N2 | 验证状态 10=未知 20=识别验证匹配 30=验证不匹配 |
| VerificationScore | C | NOT NULL | ANS0..8 | 得分0.001~1 |
| VerifyThreshold | C | NOT NULL | ANS0..8 | 验证门槛默认为0.65 |
三.报文样例
[!TIP] （测试数据不校验数据真实性，默认为验证结果为匹配，若验证其他结果，可查看“总体规范-6.1.2.4 Remark 备注”）
3201-文件上传接口请求地址与活体验证类接口不同，需注意接口地址，具体可查看交易地址
1.3201报文样例
请求报文(InstitutionID由中金分配)：
{
"TxCode":"3201",
"InstitutionID":"XXXXXX",
"TxSN":"202212051108083247844594572",
"Files":[
{
"FileContent":"iVBORw0KGg......5ErkJggg==",
"FileName":"1.png"
}
],
"Remark":""
}
响应报文：
{
"TxCode":"3201",
"Message":"SUCCESS",
"InstitutionID":"XXXXXX",
"TxSN":"202212051108083247844594572",
"Files":[
{ "FileName":"1.png",
"FileID":"2212061548260686431491336"
}
],
"Code":"2000",
"TraceNo":"2212051116273721312018597"
}
2.2316报文样例
请求报文(InstitutionID由中金分配)：
{
"TxCode":"2316",
"IdentificationNumber":"430522199209122671",
"InstitutionID":"XXXXXX",
"TxSN":"202212121452409678023077735",
"UploadFileID":"2212061548260686431491336",
"Remark":"",
"Name":"王测试"
}
响应报文：
{
"VerificationScore":"0.663",
"ResponseCode":"0000",
"TxCode":"2316",
"Message":"SUCCESS",
"InstitutionID":"XXXXXX",
"VerifyThreshold":"0.65",
"TxSN":"202212121452409678023077735",
"Verification":"20",
"ResponseMessage":"匹配",
"Code":"2000",
"TraceNo":"2212121453048421112015468"
}
该文档未解决您的疑问？
查看常见问题