通用接口

上传文件

接口说明

接口接受文件上传，返回上传后的url。

请求信息

配置说明	参数值
URL	/op/upload
Method	POST
Content-Type	multipart/form-data

form-data定义

参数	类型	描述	是否必填
file	File	要上传的文件。文件支持jpg、png、svg、pdf、xlsx	是
watermark	string	水印配置，水印功能只支持jpg、png文件，这是一个序列化后的json字符串，详细说明参考水印配置参数样例	否

注意：

• 文件大小最大10M

水印配置参数样例

{
  "data": [
    "任务名称：增城1店",
    "店铺名称：增城1店",
    "店铺编码：zz_001",
    "业代名称：小明",
    "时间：2023-07-19 16:30:00",
    "门店地址：广州市增城区xxxxx"
  ],
  "separator": "auto"
}

水印配置参数说明

参数名	类型	描述	是否必填
data	[]string	文字水印内容字符数组，最多支持10个水印信息	是
separator	string	多个文字水印信息间的拼接方式，auto：使用2个英文空格拼接 new_line: 使用换行符拼接，默认值是auto	否

响应数据

data数据格式

参数名	类型	描述
file_url	string	上传后文件的路径
md5	string	上传后文件的MD5值
file_size	int	上传后文件的大小
watermark_info	object	水印图片信息
+ file_url	string	水印图片文件的路径
+ md5	string	水印图片的MD5值
+ file_size	int	水印图片的大小

响应数据样例

{
  "code": 0,
  "message": "",
  "data": {
    "file_url": "https://f-api-dev.clobotics.cn/v?redirect=https%3A%2F%2Ff-dev.clobotics.cn%2F4%2F0040ca4d85f5e5ef7354102f486ef843.jpg",
    "md5": "0040ca4d85f5e5ef7354102f486ef843",
    "file_size": 0,
    "watermark_info": {
      "file_url": "https://f-api-dev.clobotics.cn/v?redirect=https%3A%2F%2Ff-dev.clobotics.cn%2F4%2F0040ca4d85f5e5ef7354102f486ef843.jpg",
      "md5": "0040ca4d85f5e5ef7354102f486ef843",
      "file_size": 121212
    }
  }
}