Get Status of Large File Upload Results

Last Updated on : 2023-06-15 05:12:34

Perform polling to get the status of large file upload results, and return the information about the uploaded file.
Note: The request is only supported when the return value of the /v1.0/iot-03/app-contents/file/upload/{upload_token}/infos API contains the polling_token field.

API address

GET: /v1.0/iot-03/app-contents/big-files/status

Request parameter

Parameter name	Type	IN	Required	Description
polling_token	String	query	true	After the file upload is completed, the `polling_token` value in the returned message of the API for getting the file upload result.

Return parameter

Parameter name	Type	Description
result	SecStorageScanBigRsp

Description of result

Parameter name	Type	Description
public_url	String	The URL of the file.
biz_url	String	File object key when saving content images, videos, and banner images.
file_id	String	The file ID.
error_code	String	The error code.
end	Boolean	Indicates whether the upload is completed. Valid values: `true`: yes. `false`: no.

Request example

GET: /v1.0/iot-03/app-contents/big-files/status?polling_token=12

Return example

{
    "result": {
        "biz_url": "suramar/16303288604c0e092130f.jpg",
        "public_url": "https://public-data-daily-1254153901.cos.ap-shanghai.myqcloud.com/suramar/16303288604c0e092130f.jpg?sign=q-sign-algorithm%3Dsha1%26q-ak%3DAKID85RK8j3CFNI7i7pEuSkPp26xZvA9jPgp%26q-sign-time%3D1630329000%3B1630332600%26q-key-time%3D1630329000%3B1630332600%26q-header-list%3Dhost%26q-url-param-list%3D%26q-signature%3Dbaa82ddce73ddcb10dbd077f2d5feb643cbe47e1",
        "file_id": "a72b1630329000026",
        "end": true
    },
    "t": 1630329011028,
    "success": true
}

Error code

For more information, see error code.

Prev DocGet File Upload Results

Next DocFile download