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无效文件格式