文件上传接口文档 - tis-data-upload/fileupload-multi/fileInfo - 常规

文件上传接口文档 - tis-data-upload/fileupload-multi/fileInfo

1. 接口概述

该接口用于上传文件，支持分片上传。

1.1. 接口地址

外网: http://113.108.254.104:29090/tis-data-upload/fileupload-multi/fileInfo
内网: http://192.168.10.2:29090/tis-data-upload/fileupload-multi/fileInfo

1.2. 接口方法

POST

1.3. 接口参数

| 字段英文 | 数据类型 | 必填 | 说明 | |---|---|---|---| | | fileName | String | Y | 带后缀文件名，如: 'logo.png' | | length | long | Y | 文件字节长度 | | partSize | int | Y | 分片大小。单位为字节。注：1字节=8位 | | md5 | String | Y | 文件MD5值，用于匹配是哪个文件，同时校验文件完整性。 | | deviceNo | String | Y | 见章节 1.1.1 设备号 | | dataTime | Timestamp | Y | 数据采集时间精确到毫秒保留3位，格式为: yyyy-MM-dd HH:mm:ss.SSS | | checkId | long | Y | 趟次编号格式： 11位数字，见章节 1.1.5 趟次编号，用于与告警记录匹配。 | | lbId | long | Y | 工控机前端文件登记表的ID，用于与告警记录匹配。 | | currStationId | int | Y | 当前站点ID | | nextStationId | int | Y | 下一站点ID | | direction | int | Y | 行车方向。0: 下行，1: 上行 | | speed | int | Y | 行车速度，单位KM/h | | distance | int | Y | tcms离站距离 | | absDistance | Double | Y | 绝对距离值。有电子标签的线路会传递此值，没有则写字符串'null'。 | | cameraNo | int | Y | 相机编号，参见相机编号与部件映射. | | imageNo | int | Y | 图片编号，大于或等于1. | | startMileage | String | Y | 起始公里标。工控机端图片文件夹名称。 | | alarms | String | Y | JSON数组序列化成JSON字符串,每张图片至少包含1个告警的数据。示例1: 该图片只有一个告警. [[故障类型ID,x,y,w,h,[量化参数],z]]。示例2: 该图片有两个告警 [[故障类型ID,x,y,w,h,[量化参数],z], [故障类型ID,x,y,w,h,[量化参数],z]] 注：故障类型ID参见故障类型章节。x,y是故障画框位置左上角坐标，w,h为画框宽高度；道岔告警xywh可以写0。注：z表示自信度，非空，默认值为-1 量化参数参见故障类型表格中“量化参数字段”。量化参数。是一个JSON数组。有以下几种模式：三个域：[长，宽，高] 两个域：[长，宽] 一个域：[长/宽/高/位移量(长度)] 无域：请填空字符串，或[] | | redo | int | Y | 此参数默认为1，表示此文件需要强制重传。如服务器存已传输完成的文件则先删除重新接收；如服务器存在传输中的文件，所有已传输完成的分片全部作废，所有分片需要重新传。其他值：正常传输。 | | lineId | String | Y | 数据报文传输时，必须携带lineId参数，用于兼容线网级应用场景。 |

1.4. 接口测试步骤

打开Postman应用程序。
在左上角的请求类型下拉菜单中选择 'POST'。
在URL输入框中输入接口URL，根据需要选择外网或内网的URL。
在请求参数部分，添加以下参数：
- fileName: 带后缀文件名，如: 'logo.png'
- length: 文件字节长度
- partSize: 分片大小，单位为字节
- md5: 文件MD5值
- deviceNo: 设备号
- dataTime: 数据采集时间，格式为yyyy-MM-dd HH:mm:ss.SSS
- checkId: 趟次编号，格式为11位数字
- lbId: 工控机前端文件登记表的ID
- currStationId: 当前站点ID
- nextStationId: 下一站点ID
- direction: 行车方向，0表示下行，1表示上行
- speed: 行车速度，单位KM/h
- distance: tcms离站距离
- absDistance: 绝对距离值，如果没有则填写字符串 'null'
- cameraNo: 相机编号
- imageNo: 图片编号，大于或等于1
- startMileage: 起始公里标，工控机端图片文件夹名称
- alarms: JSON数组序列化成JSON字符串，每张图片至少包含1个告警的数据
- redo: 此参数默认为1，表示文件需要强制重传
- lineId: 数据报文传输时必须携带的参数，用于兼容线网级应用场景
点击 'Send' 按钮发送请求并获取响应结果。

1.5. 响应结果

成功响应状态码：200

失败响应状态码：400

备注

本接口文档仅供参考，实际使用请以接口实现为准。
如有任何问题，请联系开发人员。

文件上传接口文档 - tis-data-upload/fileupload-multi/fileInfo