Create Dataset API

API Information

• Request Path: /dataset/create
• 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
datasetName	String	Yes	Dataset name	Cannot be empty, 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

{
  "datasetName": "My Dataset",
  "description": "This is a test dataset",
  "provider": "User Upload",
  "tagIds": [1, 2, 3]
}

Response Body Structure

CommonResponse Object

Field	Type	Description
code	Integer	Response status code
message	String	Response message
data	DataSetCreateResp	Dataset create information

DataSetCreateResp Object

Field	Type	Description
datasetId	Long	Dataset ID

Response Examples

Success Response

{
  "code": 200,
  "message": "success",
  "data": {
    "datasetId": 8
  }
}

Failure Response

{
  "code": 400,
  "message": "Dataset name is required",
  "data": null
}

Error Code Description

Error Code	Description
200	Success
400	Request parameter error
401	Unauthorized
500	Server internal error

Usage Instructions

1. This API is used to create new datasets
2. Dataset name is required and cannot exceed 50 characters
3. Dataset description is optional but cannot exceed 1024 characters
4. Dataset cover image can be uploaded (optional)
5. At least one tag ID must be specified
6. User authentication is required, valid Authorization token must be included in request headers

Notes

• Dataset name cannot be empty
• Dataset name length cannot exceed 50 characters
• Dataset description length cannot exceed 1024 characters
• Tag ID list cannot be empty
• Image file size and format limitations refer to system configuration