Appearance
Query Folder Information API
API Information
- Request Path:
/datafile/query/folder/info - 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 |
|---|---|---|---|---|
| dirPath | String | Yes | Directory path | Must be a valid directory path |
Parameter Example
/datafile/query/folder/info?dirPath=/data/satelliteResponse Body Structure
CommonResponse Object
| Field | Type | Description |
|---|---|---|
| code | Integer | Response status code |
| message | String | Response message |
| data | DataFolderInfo | Folder information response |
DataFolderInfo Object
| Field | Type | Description |
|---|---|---|
| allFilesSize | Double | Total size of all files in GB |
| filesCount | Integer | Total number of files in the folder |
Response Examples
Success Response
json
{
"code": 200,
"message": "success",
"data": {
"allFilesSize": 25.6,
"filesCount": 25
}
}Failure Response
json
{
"code": 404,
"message": "Folder not found",
"data": null
}Error Code Description
| Error Code | Description |
|---|---|
| 200 | Success |
| 400 | Request parameter error |
| 401 | Unauthorized |
| 404 | Folder not found |
| 500 | Server internal error |
Usage Instructions
- This API is used to query additional information about a folder
- User authentication is required
- Directory path must be provided as query parameter
- Returns folder statistics including file counts, sizes, and subdirectories
Notes
- Directory path is required and must be a valid directory
- Returns comprehensive folder statistics
- Useful for folder management and analysis
- User authentication token must be included in request headers