一、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 | ||
二、4040-行驶证ocr
1. 接口功能
解析行驶证照片信息。需要将图片先通过3201接口上传到服务器，然后再发送4040验证请求。上传照片ID（UploadFileID）对应3201接口响应的FileID。（接口时序图：ocr接口介绍）
2. 报文结构
请求报文：
| 报文元素 | 出现要求 | 非空约束 | 数据格式 | 说明 |
|---|---|---|---|---|
| InstitutionID | R | NOT NULL | N1..4 | 机构编号 |
| TxCode | R | NOT NULL | ANS1..8 | 交易类型 |
| TxSN | R | NOT NULL | ANS1..32 | 交易流水号 |
| UploadFileID | R | NOT NULL | ANS1..32 | 上传照片ID |
| Remark | O | ANS0..64 | 备注 |
响应报文：
| 报文元素 | 出现要求 | 非空约束 | 数据格式 | 说明 |
|---|---|---|---|---|
| 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 | 通道响应消息 |
| Owner | C | NOT NULL | ANS0..50 | 所有人 |
| BrandModel | C | NOT NULL | ANS0.. | 品牌型号 |
| VehicleNo | C | NOT NULL | ANS0..20 | 号牌号码 |
| CrossWeight | C | NOT NULL | NS0..10 | 总质量 |
| IssueDate | C | NOT NULL | YYYYMMDD | 发证日期 |
| RegisterDate | C | NOT NULL | YYYYMMDD | 注册日期 |
| CurbWeight | C | NOT NULL | NS0..10 | 整备质量 |
| EngineNumber | C | NOT NULL | ANS0..32 | 发动机号码 |
| Size | C | NOT NULL | ANS0..32 | 外廓尺寸 |
| FileNo | C | NOT NULL | ANS0..32 | 档案编号 |
| Address | C | NOT NULL | ANS0..2000 | 地址 |
| InspectionRecord | C | NOT NULL | ANS0.. | 检验记录 |
| Vin | C | NOT NULL | A0..17 | 车辆识别代码 |
| Passengers | C | NOT NULL | N0..5 | 核定载人数 |
| VehicleType | C | NOT NULL | ANS0..32 | 车辆类型 |
| UseType | C | NOT NULL | ANS0..32 | 使用性质 |
| LoadWeight | C | NOT NULL | NS0..10 | 核定载质量 |
| TestValidityDay | C | NOT NULL | ANS0..20 | 检验有效期 |
| TowWeight | C | NOT NULL | N0..16 | 准牵引总质量 |
| Remark | C | NOT NULL | ANS0..2000 | 备注 |
三、报文样例
[!TIP] （测试数据不校验数据真实性，默认为验证结果为匹配，若验证其他结果，可查看“总体规范-6.1.2.4 Remark 备注”）
3201-文件上传接口请求地址与ocr接口不同，需注意接口地址，具体可查看ocr交易地址
1.3201报文样例
请求报文(InstitutionID由中金分配)：
{
"TxCode":"3201",
"InstitutionID":"XXXXXX",
"TxSN":"202301161632415618763945679",
"Files":[
{
"FileContent":"iVBORw0KGg......5ErkJggg==",
"FileName":"1.png"
}
],
"Remark":""
}
响应报文：
{
"TxCode":"3201",
"Message":"SUCCESS",
"InstitutionID":"XXXXXX",
"TxSN":"202301161632415618763945679",
"Files":[
{
"FileName":"1.png",
"FileID":"2301161636264863917961152"
}
],
"Code":"2000",
"TraceNo":"2301161636262801312017612"
}
2.4040报文样例
请求报文(InstitutionID由中金分配)：
{
"TxCode":"4040",
"InstitutionID":"XXXXXX",
"TxSN":"202301170955395958888168780",
"UploadFileID":"2301161636264863917961152",（3201接口返回）
"Remark":""
}
响应报文：
{
"Owner":"合小合",
"VehicleNo":"闽L0TENO",
"Address":"福建省厦门市思明区小合路100号",
"CurbWeight":"",
"Message":"SUCCESS",
"InstitutionID":"XXXXXX",
"Size":"",
"TowWeight":"",
"TestValidityDay":"",
"Remark":"",
"FileNo":"",
"EngineNumber":"ABC123789",
"TxSN":"202301170955395958888168780",
"TraceNo":"2301170958561241112015058",
"ResponseCode":"1000",
"TxCode":"4040",
"UseType":"非营运",
"VehicleType":"小型越野客车",
"RegisterDate":"2015-06-05",
"IssueDate":"2015-06-08",
"InspectionRecord":"",
"ResponseMessage":"查询成功",
"Code":"2000",
"LoadWeight":"",
"Passengers":"",
"Vin":"ABABCDCD989847473",
"CrossWeight":"",
"BrandModel":"迈凯S BBB666"
}
该文档未解决您的疑问？
查看常见问题