Query Task Detail API

API Information

• Request Path: /processtask/query/task/detail
• Request Method: POST
• Content-Type: application/json

Request Headers

Parameter	Type	Required	Description
Authorization	String	Yes	User authentication token
Content-Type	String	Yes	Must be set to application/json

Request Body Parameters

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

Parameter Example

{
  "taskId": 12345
}

Response Body Structure

CommonResponse Object

Field	Type	Description
code	Integer	Response status code
message	String	Response message
data	DataTaskDetailResp	Task detail information

DataTaskDetailResp Structure

Field	Type	Description
id	Long	Task ID
taskType	Integer	Task type: 1-Imagery Fusion, 2-Imagery Mosaicking, 4-Cloud Removal, 6-Band Merging, 7-Index Calculation (NDVI), 8-Index Calculation (EVI), 9-Index Calculation (NDWI), 10-Index Calculation (NDBI), 11-Index Calculation (BAI)
taskName	String	Task name
status	Integer	Task Status: 5-PROCESSING, 7-PUBLISHED, 8-PUBLISH_FAILED
outputPath	Long	Output Folder Id in Data Storage
outputFileName	String	Output File Name in Data Storage
datas	List<ProcessTaskDataVo>	Input data list
output	ProcessTaskResultDataVo	Output data information

ProcessTaskDataVo Structure

Field	Type	Description
dataFileId	Long	Data file ID
bandInfoId	List<Long>	Band information ID list
bandId	Long	Band ID
thumbnailUrl	String	Thumbnail URL
fileName	String	File name
originalBandName	String	Original band name
metadataId	Long	Metadata ID
taskId	String	Task ID

ProcessTaskResultDataVo Structure

Field	Type	Description
dataFileId	Long	Data file ID
thumbnailUrl	String	Thumbnail URL
fileName	String	File name
metadataId	Long	Metadata ID
taskId	String	Task ID

Response Examples

Success Response

{
  "code": 200,
  "message": "OK",
  "data": {
    "id": 702,
    "taskType": 6,
    "taskName": "API TEST BAND MERGING",
    "status": 5,
    "outputPath": 706,
    "outputFileName": "ApiTestBandMergingResult",
    "datas": [
      {
        "dataFileId": 542,
        "type": null,
        "bandInfoId": [
          11854
        ],
        "bandId": 11854,
        "thumbnailUrl": "https://eopocstorage.blob.core.windows.net/eo-qa/data_test%2FRaster%2F2025%2F11%2F5%2F2JX0Hq0Hg_1762309488%2F2JX0Hq0Hg_1762309488_thumb.jpg?sv=2023-11-03&se=2025-11-24T13%3A20%3A51Z&sr=b&sp=r&sig=iKZsEy4YYHbvtq3OU9cfSXq3xUEG7jZ0EgDDTL1WCWY%3D",
        "fileName": "LC8_L2_61043_20221123_29_B4",
        "originalBandName": "Red",
        "metadataId": 309,
        "taskId": "1985949195927285760"
      },
      {
        "dataFileId": 543,
        "type": null,
        "bandInfoId": [
          12485
        ],
        "bandId": 12485,
        "thumbnailUrl": "https://eopocstorage.blob.core.windows.net/eo-qa/data_test%2FRaster%2F2025%2F11%2F5%2F2JX0Hp0Hf_1762309470%2F2JX0Hp0Hf_1762309470_thumb.jpg?sv=2023-11-03&se=2025-11-24T13%3A20%3A51Z&sr=b&sp=r&sig=xGkE%2FqJUdFt1RGXQG7ic1ihNiwwV9Hc3T9EIwNxZ2nY%3D",
        "fileName": "LC8_L2_61043_20221123_29_B3",
        "originalBandName": "Green",
        "metadataId": 310,
        "taskId": "1985949196015366144"
      },
      {
        "dataFileId": 541,
        "type": null,
        "bandInfoId": [
          12088
        ],
        "bandId": 12088,
        "thumbnailUrl": "https://eopocstorage.blob.core.windows.net/eo-qa/data_test%2FRaster%2F2025%2F11%2F5%2F2JX0Ho0He_1762309440%2F2JX0Ho0He_1762309440_thumb.jpg?sv=2023-11-03&se=2025-11-24T13%3A20%3A51Z&sr=b&sp=r&sig=3KrIQhq8%2BlT%2FbHWurEXSWgSvn8ffbh12%2B2293IKVLRE%3D",
        "fileName": "LC8_L2_61043_20221123_29_B2",
        "originalBandName": "Blue",
        "metadataId": 308,
        "taskId": "1985949195818233856"
      },
      {
        "dataFileId": 544,
        "type": null,
        "bandInfoId": [
          12058
        ],
        "bandId": 12058,
        "thumbnailUrl": "https://eopocstorage.blob.core.windows.net/eo-qa/data_test%2FRaster%2F2025%2F11%2F5%2F2JX0Hr0Hh_1762309507%2F2JX0Hr0Hh_1762309507_thumb.jpg?sv=2023-11-03&se=2025-11-24T13%3A20%3A51Z&sr=b&sp=r&sig=S%2FIfL1OgLFPbdxG66M755jnOaOdXbeCSC2Z1BJbndRw%3D",
        "fileName": "LC8_L2_61043_20221123_29_B5",
        "originalBandName": "Near Infrared",
        "metadataId": 306,
        "taskId": "1985949195553992704"
      },
      {
        "dataFileId": 545,
        "type": null,
        "bandInfoId": [
          12445
        ],
        "bandId": 12445,
        "thumbnailUrl": "https://eopocstorage.blob.core.windows.net/eo-qa/data_test%2FRaster%2F2025%2F11%2F5%2F2JX0Hs0Hi_1762309527%2F2JX0Hs0Hi_1762309527_thumb.jpg?sv=2023-11-03&se=2025-11-24T13%3A20%3A51Z&sr=b&sp=r&sig=stwTXEShDELYCagMkaZ34iziYnR4pYAZMI1in2obp0w%3D",
        "fileName": "LC8_L2_61043_20221123_29_B6",
        "originalBandName": "SWIR 1",
        "metadataId": 307,
        "taskId": "1985949195725959168"
      }
    ],
    "output": {
      "dataFileId": 778,
      "thumbnailUrl": "https://eopocstorage.blob.core.windows.net/eo-qa/data_test%2FRaster%2F702%2Fband_merge_702_thumb.jpg?sv=2023-11-03&se=2025-11-24T13%3A36%3A10Z&sr=b&sp=r&sig=3%2BlFIg%2FkYwMaQ%2F9GuIIGk50x6FGnFkzQtc8enw5FKss%3D",
      "fileName": "ApiTestBandMergingResult",
      "metadataId": null,
      "taskId": null
    }
  }
}

Failure Response

{
  "code": 400,
  "message": "Task ID is required",
  "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 query detailed information of a specific processing task
2. Task ID is required and must be a valid task ID
3. User authentication is required, valid Authorization token must be included in request headers
4. The response includes complete task information including input data and output results

Notes

• Task ID must be provided and cannot be null
• User must have appropriate permissions to access the task details
• The response structure varies based on task type and processing status