Appearance
文件上传
文件上传接口
支持 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] | 是 | 文件列表 | ||||||||
|
返回示例
json
{
"code": 0,
"text": "上传成功",
"time": 1668492908,
"sign": "15a237a254887f4c73407646f137cb4c56e4f28e7932a8c6f507e8a0217eaa86",
"data": "{ \"files\":[{\"code\":\"KRdChiYHfiAkkxUSeiIPKPpwgQr5GqOrm3KOkpKWjXMkLZGbGYQILPARjpb5jxK5fnQvKajCdPhvd34x\", \"size\":12354 \"name\": \"abcd.jpg\"}]}"
}
返回状态
状态 | 说明 |
---|---|
0 | 上传成功 |
1101001 | 上传失败 |
1101002 | 不支持的文件类型 |
1101003 | 无效文件格式 |