File Application First Download URL
API Description: Download the corresponding version based on the version number. If no version number is provided, the latest version is used by default.
When users download an application for the first time, they need to download the latest version. This API's request address is fixed. If no version number is provided, it automatically gets the latest uploaded version, making it suitable for use in fixed download buttons.
📮 Request Information
Request URL
GET https://api.upgrade.toolsetlink.com/v1/file/download?fileKey=LOYlLXNy7wV3ySuh0XgtSg&versionCode=1
Request Parameters
| Parameter Name | Required | Type | Example Value | Description |
|---|---|---|---|---|
| fileKey | Yes | string | LOYlLXNy7wV3ySuh0XgtSg | Unique file application identifier |
| versionCode | No | int | 1 | Application version number, defaults to latest version if not provided |
📮 Response Information
Success
Direct file download starts
Typical Error Response Body
json
{
"code": 404001,
"msg": "No available version obtained",
"docs": "No corresponding application version found, please confirm whether it has been correctly created in the system. Please refer to the documentation: http://upgrade.toolsetlink.com/upgrade/recommend/file/app-version.html",
"data": null
}📊 Status Codes
| HTTP Status Code | Code | Scenario Description | Solution |
|---|---|---|---|
| 200 | Direct file download starts | ||
| 400 | 400001 | Invalid request | |
| 400 | 400002 | Parameter missing | |
| 400 | 400003 | Invalid parameter | |
| 400 | 400004 | Invalid header | |
| 400 | 400005 | Invalid body | |
| 401 | 401001 | Authentication failed | |
| 401 | 401002 | Signature verification failed | |
| 404 | 404001 | Resource not found | |
| 404 | 404002 | Record not found | |
| 404 | 404003 | Processing method not found | |
| 404 | 404004 | Request not found | |
| 429 | 429001 | Application task strategy request rate limit | The request rate limit configured for the current upgrade task has been reached, please try again later. |
| 500 | 500001 | Server internal error | Please contact us Contact Us |
| 500 | 500002 | Server internal data verification failed | Please contact us Contact Us |