Get Download URL API

API Information

• Request Path: /analysis/task/get/Download/url
• Request Method: GET
• Content-Type: application/json

Request Headers

Parameter	Type	Required	Description
Authorization	String	Yes	User authentication token

Request Parameters

Parameter	Type	Required	Description	Constraints
taskId	String	Yes	Task ID	Must be a valid task ID

Parameter Example

/analysis/task/get/Download/url?taskId=12345

Response Body Structure

CommonResponse Object

Field	Type	Description
code	Integer	Response status code
message	String	Response message
data	DownloadUrlResp	Download URL response

DownloadUrlResp Object

Field	Type	Description
taskId	String	Task ID
downloadUrls	List<DownloadUrlVo>	List of download URLs
totalSize	Long	Total file size in bytes

DownloadUrlVo Object (Nested in DownloadUrlResp)

Field	Type	Description
fileName	String	File name
downloadUrl	String	Download URL
fileSize	Long	File size in bytes
expiresAt	String	URL expiration timestamp

Response Examples

Success Response

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "12345",
    "downloadUrls": [
      {
        "fileName": "ndvi_result.tif",
        "downloadUrl": "https://example.com/download/ndvi_result.tif?token=...",
        "fileSize": 512000,
        "expiresAt": "2024-01-01T11:00:00Z"
      },
      {
        "fileName": "analysis_report.pdf",
        "downloadUrl": "https://example.com/download/analysis_report.pdf?token=...",
        "fileSize": 150000,
        "expiresAt": "2024-01-01T11:00:00Z"
      }
    ],
    "totalSize": 662000
  }
}

Failure Response

{
  "code": 404,
  "message": "Task not found",
  "data": null
}

Error Code Description

Error Code	Description
200	Success
400	Request parameter error
401	Unauthorized
404	Task not found
500	Server internal error

Usage Instructions

1. This API is used to get download URLs for analysis task results
2. User authentication is required
3. Task ID must be provided as query parameter
4. Returns download URLs for all output files from the analysis task

Notes

• Task ID is required and must be a valid task ID
• Returns temporary download URLs that expire
• User authentication token must be included in request headers