图片上传 - 开放平台

curl --location --request POST 'https://saas-open.vhall.com/v3/commons/upload/index' \ --header 'platform: 15' \ --header 'Content-Type: multipart/form-data' \ --form 'resfile=@"/Users/Rui/Downloads/v3.jpeg"' \ --form 'type="image"' \ --form 'app_key=""' \ --form 'sign_type=""' \ --form 'signed_at=""' \ --form 'sign=""'

{ "code": 200, "msg": "", "data": { "file_url": "72035607/202506/f4/94/测试.jpg", "lines": "0", "domain_url": "https://cnstatic01.e.vhall.com/upload/72035607/202506/f4/94/测试.jpg" }, "request_id": "0456e278-ea76-441f-914d-34e15a3c7488" }

请求参数

Header 参数

Content-Type

string

必需

示例值:

multipart/form-data

platform

integer

可选

默认值:

Body 参数multipart/form-data

resfile

file

必需

上传的文件 input type="file" name ="resfile"，此字段不参与签名

示例值:

file:///Users/Rui/Downloads/v3.jpeg

type

string

必需

固定传image，支持后缀：'bmp','gif','jpg','psd','png','jpeg'

示例值:

image

force_name

string

可选

文件名称（默认不传，系统自动生成hash名称）

app_key

string

必需

平台分配的APP KEY

默认值:

sign_type

integer

必需

签名类型 : 0=MD5,1=RSA,2=SHA256,3=SM3

默认值:

signed_at

integer

必需

签名时间戳 , 当前 UNIX 时间戳，单位为秒。注意：与服务器时间差不得超过5秒

默认值:

sign

string

计算生成的签名值

必需

默认值:

返回响应

🟢200成功

application/json

Body

code

integer

必需

返回结果的状态码（200 成功)

msg

string

必需

当返回结果的状态码不为200时，包含的错误信息

data

object

必需

file_url

string

相对地址

必需

lines

string

该字段已废弃

已废弃

domain_url

string

全路径

必需

request_id

string

必需