# Upload File
# API Description
This API is used to upload file to OSS ,20M is max size.Total size is 500G. Below file type is allowed : .JPG.JPEG.GIF.TIF.BMP.PNG.AI.TGA.MP4.MP3.WAV.DOC.WMA.WPEG.RAR.ZIP.DAT.DOCX.AVI.ISO.PDF.XLS.XLSX.CSV.PPTX.TXT.GZ.TAR.MPG.RTF.M4A.PPT.MOV
# Environment
# Test
https://oversea.saicmaxus.com/australia/test/fir/file/upload (opens new window)
# Prod
https://oversea.saicmaxus.com/australia/fir/file/upload (opens new window)
# Method
POST
# Request
# Authorization
Set 'maxus_jwt' in header,see in Get Maxus JWT Token
# Payload
| Parameter | Type | Required | Description | 中文描述 |
|---|---|---|---|---|
| file | File | Yes | upload file limit in 20M | 文件限制在20MB内 |
# Example
curl --location 'https://oversea.saicmaxus.com/australia/test/fir/file/upload' \
--header 'maxus_jwt: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJhc2NDb2RlIjoiNDE5ODEzMCIsImFzY0lkIjo0MTk4MTMwLCJhc2NOYW1lIjoiQVRFQ08iLCJjYWxsQmFja1VybCI6IjEiLCJleHBpcmVUaW1lU3RhbXAiOiIxNzA0MzY1MDQ1OTgzIiwicmVtYXJrIjoicHJpdmF0ZT09MTI1Njk4NjU0ODQ3ODg4MTAyMjA2MjAxODEzMzgxNTA2MTE2ODk4Njg1MDgyMzUyNTcyNjAxMDg1MTkzMzg0OTE4MjEzOTUzNDUzMjY3NDAxNzgyMjQ3NTc4OTMwNDU4MTg3Mzg5Mjk5OTU1MjU5MjUwMTI4MzE5OTYxNTYzNjE5MTIxOTQ4MzI0MTA3NTI3MDc0NjEyMzg4MjM4NzAxMjQzNzA2ODE3NjgyNTEyNjk1NDc4OTQ1MjYzOTc5NTc2NjU2MTUwMzgyMTk0NzQ1OTY0OTg4OTc0NTc5ODIyNzc5NjM2NTYxNTYyOTM5Mjc1ODkwMTExNTQ3ODIxNjMzNzMxMzQ2MTc2MjU1ODMzOTEwNTE5NTYyNDg2NTI3OTE5MzMxMTYxMjY2ODA5OTE3ODc4Nzltb2R1bGVzPT0zNDQ2NzU5MjY3NjUwMDkzMjE4MDA3NTU2NTE5MTY1NDAxMTgyODEzNDE3MTYxOTMzMjY3MzE0MzQ4MzA4ODEwMTk2MDcyNzUwNTA5ODg2NjEwMzY1MDk1OTExMjk3MjE2MjI5NTEzOTA5NjE1NTU2MzUzMzk2MzY1NzExOTA0NjUwNjg3NDczOTkzOTUxMTE2MzkwMjcxNDE1MTUyMjE0Mzc3NDI4MjY1NTMwOTQyMzA4MTUxNTk2NjMxOTI0MTA0NTAyMTIwOTk0NzI2MDcxMDcxNTc3MTMwMzExMzg4NTg1MjAyMTA1NjM1MjMwNTIzMTc2NDY2MzU4MDA1NDU2MjQ3NjMwMjY5NzQzMzE1OTQxODAyNTQwNjcyNzM0ODg5MDExODAxMDI2ODAxOTIxNjkzMSIsInJzYVZPIjp7InJzYVB1YmxpY0V4cG9uZW50IjoiMTAwMDEiLCJyc2FNb2R1bGVzIjoiOGNmMDhkMjkxNzdjYTJiOTQyN2M1YTJiMWQ0MTUzZjg2MGVhNWVkNzAxZGFlYTk4Mzg5YWJmZmNjNGQ1OTQ0Mjk5ZWQ4YmRkZjRkMWI1MjhhNzQ2ZGE2Yjk3OTkyODJlOGJiNTUzMDQ5NWE0MjRkZTcwM2NjMTc4ZWQyZGUwNDE1OTliY2FjMWY1MTIzNjg5NmU2MWM3M2RkYTk1ODZmOWNjZjRlMjI0NzMxZmEzNzFkOTg0ODg5MzhlZWJmNDUzODhlMTc5MjMxNTExMjY3ODM4YTE5MGJmOWE2N2YzYjcwYzg5ZWRlMWE2ODQ2ZGNjZWZkY2I0OTUzNDRmMDIzZiIsInJzYVByaXZhdGVFeHBvbmVudCI6IjFlMTNjZmVjMmYwOGY4MjkxNTE5Mzg5Y2VlZDc1YzM2MmI2ODk4ZThjNThhOTQ3OWZiY2E3YWEyNTRkNzQ3OTY5NzA2ZWNjYzY3NGNjMTllNzU2NDU3ODQ5MjhiYWFkOTk0MTMxNDJlNmM0OGU1NWQ1YjEyN2MyZjc0NWU0ZmY3MGRmZWU4MWQ0YWY4OWM0ODg1NTViMzMwMmE4OWY3ZjcwM2JmMTU0YjM1ZmM5NmVhZjMxYTFhYjMwNTQwMTE4ZGEzY2ZhY2ViZTZkMTI3ZmEyODQzZWQ3MDQ0NDJlZWE5ZDc3ODUxMTlhN2Q3MjkzY2U3NTliNGE5ZmIwODA0MzEiLCJnYWluQ291bnQiOjkxfSwic2FwQWNjb3VudCI6IjQxOTgxMzAiLCJzZXJ2aWNlQ29kZSI6IkF0ZWNvIiwiaWF0IjoxNzA0MzY0ODY1LCJleHAiOjE3MDQzNjYzMDV9.1ScGEdF5iBlnygZ5iq3uNkGAM3OKyEbAEkiHRgFRXJ4' \
--header 'Cookie: HttpOnly' \
--form 'file=@"/Users/chenghao/Desktop/4801703142285_.pic.jpg"'
# Response
# Payload
| Parameter | Type | Description |
|---|---|---|
| status | int | 1: Success, 0: Failure |
| errMsg | String | Error message |
| data | String | Encrypted file upload url |
# Response Code (errCode)
| Status Code | Description |
|---|---|
| 200 | Success |
| 400 | Bad Request |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not Found |
| 500 | Unknown Error |
| 503 | Dependency System Unavailable |
# Example
# OK
{
"status": 1,
"errCode": "200",
"errMsg": "SUCCESS",
"data": "cb2bf31fca3f4dbeb6f8863c20d41eb4263a5ea46afae55aae70a8e3da74dd9b2d2410893ffcc1f40ff4465301b4fc88521faea1e0a73d388060d4f579ec40fd1d5c0434652c00fc4aa0ae40c5f37feebd27ff5de04a5ff32e4c3e9f87a0b9e6418fa31e73bdcdc9de25c15868eb4f06"
}
# NOT FOUND
{
"status": 0,
"errMsg": "NOT FOUND",
"errCode": "404",
"data": null
}
# INTERNAL ERROR
{
"status": 0,
"errMsg": "DEPENDENCY SYSTEM UNAVAILABLE",
"errCode": "503",
"data": null
}
{
"status": 0,
"errMsg": "UNKNOWN ERROR",
"errCode": "500",
"data": null
}
# GATEWAY ERROR
http status code: 500