Download File URLs API

API Information

• Request Path: /datafile/file/urls
• 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
dataFileIds	List<Long>	Yes	Data file IDs	Array of valid file IDs

Parameter Example

/datafile/file/urls?dataFileIds=12345,12346,12347

Response Body Structure

CommonResponse Object

Field	Type	Description
code	Integer	Response status code
message	String	Response message
data	DataFileUrlsResp	Download URLs response

DataFileUrlsResp Object (Nested in CommonResponse)

Field	Type	Description
urlList	List<DataFileUrl>	List of download URLs

DataFileUrl Object (Nested in DataFileUrlsResp)

Field	Type	Description
url	String	Download URL
dataFileId	Long	Data file ID
name	String	File name
path	String	File path (used for drone images uploaded via OBS path)

Response Examples

Success Response

{
  "code": 200,
  "message": "success",
  "data": {
    "urlList": [
      {
        "url": "https://example.com/download/satellite_image_001.tif?token=...",
        "dataFileId": 12345,
        "name": "satellite_image_001.tif",
        "path": "/data/satellite/satellite_image_001.tif"
      },
      {
        "url": "https://example.com/download/metadata.json?token=...",
        "dataFileId": 12346,
        "name": "metadata.json",
        "path": "/data/satellite/metadata.json"
      }
    ]
  }
}

Failure Response

{
  "code": 400,
  "message": "Invalid file IDs",
  "data": null
}

Error Code Description

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

Usage Instructions

1. This API is used to get download URLs for multiple files
2. User authentication is required
3. Data file IDs must be provided as query parameters
4. Returns download URLs with expiration times

Notes

• Data file IDs are required and must be valid file IDs
• Multiple file IDs can be provided as comma-separated values
• Download URLs are temporary and expire
• User authentication token must be included in request headers