Skip to content

文件上传 ​

文件上传接口 ​

支持 JPG、BMP、PNG 格式。文件大小不能超过 2M ​

请求路径/upload
请求方法POST
请求头multipart/form-data

请求参数 ​

公共参数 ​

参数名称类型必填说明
key标识string是开发者唯一标识
time时间戳string是当前 unix 时间戳,精确到秒
sign数据签名string是数据签名,详见 签名算法
data业务参数JSON string是业务参数,详见下例表格,为空请传{}

业务参数 ​

无业务参数,业务参数 data 请传{}

上传文件 ​

支持多个文件同时上传

表单名随意,但不能与 公共参数 冲突

请求示例 ​

json
{
  "key": "d787d45a68b323448",
  "data": "{}",
  "sign": "b649ef89371dbd5c47686efbabf2e65....",
  "time": 1668671935
}

返回数据 ​

公共数据 ​

数据名称类型必填说明
code状态码int是结果状态码
text操作结果string否操作结果,为空时不返回此字段
time时间戳int是服务器当前 unix 时间戳,精确到秒
sign数据签名string是数据签名
data业务数据JSON string是业务数据,详见下例表格

返回数据 ​

参数名称类型必填说明
files文件列表[json]是文件列表
key文件参数名
code文件代码
size文件大小,单位:字节
name文件名

返回示例 ​

json
{
  "code": 0,
  "text": "上传成功",
  "time": 1668492908,
  "sign": "15a237a254887f4c73407646f137cb4c56e4f28e7932a8c6f507e8a0217eaa86",
  "data": "{ \"files\":[{\"code\":\"KRdChiYHfiAkkxUSeiIPKPpwgQr5GqOrm3KOkpKWjXMkLZGbGYQILPARjpb5jxK5fnQvKajCdPhvd34x\", \"size\":12354 \"name\": \"abcd.jpg\"}]}"
}

返回状态 ​

状态说明
0上传成功
1101001上传失败
1101002不支持的文件类型
1101003无效文件格式