Appearance
Update Dataset API
API Information
- Request Path:
/dataset/update - Request Method:
POST - Content-Type:
multipart/form-data
Request Headers
| Parameter | Type | Required | Description |
|---|---|---|---|
| Authorization | String | Yes | User authentication token |
| Content-Type | String | Yes | Must be set to multipart/form-data |
Request Body Structure
| Field | Type | Required | Description | Constraints |
|---|---|---|---|---|
| id | Long | Yes | Dataset ID | Must be a valid dataset ID |
| datasetName | String | No | Dataset name | Maximum 50 characters |
| description | String | No | Dataset description | Maximum 1024 characters |
| picture | File | No | Dataset cover image | Image file |
| provider | String | No | Dataset source | Any string |
| tagIds | List<Long> | Yes | Tag ID list | Array of tag IDs |
Parameter Example
json
{
"id": 12345,
"datasetName": "Updated Dataset Name",
"description": "Updated dataset description",
"provider": "Updated Provider",
"tagIds": [1, 2, 3]
}Response Body Structure
CommonResponse Object
| Field | Type | Description |
|---|---|---|
| code | Integer | Response status code |
| message | String | Response message |
| data | Boolean | Update result, true indicates success |
Response Examples
Success Response
json
{
"code": 200,
"message": "success",
"data": true
}Failure Response
json
{
"code": 400,
"message": "Dataset name exceeds maximum length",
"data": false
}Error Code Description
| Error Code | Description |
|---|---|
| 200 | Success |
| 400 | Request parameter error |
| 401 | Unauthorized |
| 404 | Dataset not found |
| 500 | Server internal error |
Usage Instructions
- This API is used to update existing datasets
- Dataset ID is required to identify which dataset to update
- User authentication is required
- Only dataset owners can update their datasets
- Returns boolean indicating update success
Notes
- Dataset ID is required and cannot be null
- Dataset name cannot exceed 50 characters
- Dataset description cannot exceed 1024 characters
- Tag ID list cannot be empty
- Image file size and format limitations refer to system configuration
- User authentication token must be included in request headers