获取用户文件上传URL，使用该URL进行文件上传
接口说明
获取的 URL 需使用阿里云 OSSSDK 进行上传
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
GET HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| FileName |
string |
是 |
上传文件的文件名。文件名格式可以上传单文件名（例如：1.jpg）或路径格式（例如：dircectory1/1.jpg） |
myfile |
| FileSizeBytes |
integer |
是 |
待上传文件的实际 Byte 大小。该值必须为待上传文件的实际 Byte 大小，在通过上传 URL 时会对文件大小进行校验 |
1024 |
| FileMd5 |
string |
是 |
待上传文件的 MD5 值。该值必须为待上传文件的实际 MD5 值，在通过上传 URL 时会对文件大小进行校验 |
54d6911ba6d59dbe68990835a409f18c |
| ContentType |
string |
是 |
上传文件类型 |
application/jpeg |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
Id of the request |
BEA5625F-8FCF-48F4-851B-CA63946DA664 |
| Code |
integer |
错误码。 |
0 |
| Message |
string |
描述信息。 |
SUCCESS |
| UploadUrl |
string |
用户文件上传链接 |
oss-bucket.oss-cn-shanghai-cloudspe.aliyuncs.com/path/userid/test.png?x-oss-date=20260602T093618Z&x-oss-expires=29&x-oss-security-token=xxxxx%2F68FY2NI6nyNgueynMjneKjKXD6l5tS5h3S2%xxxxx%xxxx%xxxxxxx%2Fb%xxxx%sdffeeeaasdf%xxx%xx%xx%xxxx%2BeASOv2N8q%xxx%2B6XBxllroojFliSTfsqGI2YMHpoRwJmyfXK32BQPb2SvQ0AM23soq%2FspAI4f9vtFG0yv9fKWMw%xxxxxxxxx%xxxxxxxx%3D%3D&x-oss-signature-version=OSS4-HMAC&x-oss-credential=STS.xxxxx%2F20260dfa202%2Fcn-shanghai-cloud%2Foss%2Faliyun_v4_request&x-oss-signature=xxxxxxxxxxxxxx |
| ExpiredTime |
string |
上传链接过期时间 |
2026-08-28T16:00Z |
示例
正常返回示例
JSON格式
{
"RequestId": "BEA5625F-8FCF-48F4-851B-CA63946DA664",
"Code": 0,
"Message": "SUCCESS",
"UploadUrl": "oss-bucket.oss-cn-shanghai-cloudspe.aliyuncs.com/path/userid/test.png?x-oss-date=20260602T093618Z&x-oss-expires=29&x-oss-security-token=xxxxx%2F68FY2NI6nyNgueynMjneKjKXD6l5tS5h3S2%xxxxx%xxxx%xxxxxxx%2Fb%xxxx%sdffeeeaasdf%xxx%xx%xx%xxxx%2BeASOv2N8q%xxx%2B6XBxllroojFliSTfsqGI2YMHpoRwJmyfXK32BQPb2SvQ0AM23soq%2FspAI4f9vtFG0yv9fKWMw%xxxxxxxxx%xxxxxxxx%3D%3D&x-oss-signature-version=OSS4-HMAC&x-oss-credential=STS.xxxxx%2F20260dfa202%2Fcn-shanghai-cloud%2Foss%2Faliyun_v4_request&x-oss-signature=xxxxxxxxxxxxxx",
"ExpiredTime": "2026-08-28T16:00Z"
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。