图片上传

POST

agent/openapi/oss/v1/upload

图片上传接口支持的图片大小上限为 3MB，请勿上传超过 3MB 的图片，否则将返回 413 错误。支持的文件格式为：png、jpg、jpeg。

该接口与其他接口不同，请求需使用 multipart/form-data 格式，公共参数需拼接在 URL 中。

Query 参数中的 data、signature 和 serialNo 需使用 URLEncoder.encode(param, "UTF-8") 进行编码，并将编码结果中的 + 替换为 %20。

示例如下：

请求参数

Query 参数

Header 参数

Body 参数multipart/form-data必填

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --globoff 'agent/openapi/oss/v1/upload?appId=128074&data={%22imgType%22%3A%221%22}&signature=fdDuM8Ikq1kKXZ+1tfGUIC6S5nX...&serialNo=20251101143253421980&timestamp=1792992479738' \
--header 'Sign-Algorithm: RSA' \
--header 'Sign-Algorithm: RSA' \
--form 'fileName=@""'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
	"data": "{\"fileId\":\"flm202610231556625008607776\"}",
	"signature": "Bl6JUjqBYGjKD8QFWYVQ+C3yhD28z8VlK+pfTQPynajko4qHUkgcSD8eYFhFDGwQCc79El6jG4G29R9o4iBdi01HZiW7/40cPAYxMB2KlT2MI7fu9ORW/CpnKOq2hEW8i2/By9azQFgeotUoKB+E8FddALosYTQqu7maZmyUOzltAiaeE5hLbkVMHuRANpZKe13CaJx4rjc+4wyD0fUKXP2XteY8otTUuVTU4DazZbo0bq+mj0zZ0d7bhjkCgHi406P8uC8dkfeHrjpNU3yMOrp3TadZV+GOS+uIjZsBCw9vr1+3EbRMs6X+Ori86C2w7gsHR2IfZlHmjYuP0bsPZQ==",
	"code": "0000",
	"msg": "操作成功!",
	"traceId": "0cfd436f1f2c4c869971f2946d663d2a"
}

修改于 2026-10-27 07:40:01

业务指引

商户进件