# 数据集创建
通过接口创建一个新的数据集，并且返回数据集id。
# 请求地址和请求方式
| HTTP请求地址 | 请求方式 |
|---|---|
| {service}/api/v1/datasets | POST |
# 请求参数Header
| 序号 | 参数 | 内容 |
|---|---|---|
| 1 | Content-Type | application/json |
# 请求参数Body
| 序号 | 参数 | 类型 | 是否必填 | 长度限制 | 描述 | 示例值 |
|---|---|---|---|---|---|---|
| 1 | name | string | 是 | 2-50 | 数据集名称，如果标注平台中存在同名数据集，则返回：数据集名称已存在，请重新命名 | 人脸检测数据集001 |
| 2 | describe | string | 否 | 200 | 数据集描述 | 亚洲人脸检测 |
| 3 | type | int | 是 | 1 | 数据集类型： 0：图片；1：语音；2：文本；3：视频；6：点云；7：图片-大图 | 0 |
| 4 | pattern | int | 是 | 1 | 数据集上传形式： 0：原始文件；1：索引文件 | 0 |
| 5 | tags | string[] | 否 | - | 数据集标签组。单个标签长度为：15;总标签数量为：5 | ["face","detection"] |
注意：通过接口上传时，数据集默认不去重
# 请求示例
{
"name": "人脸检测数据集001",
"describe": "亚洲人脸检测",
"type": 0,
"pattern": 0,
"tags": ["face","detection"]
}
# 返回结果（返回正确）
{
"code":0,
"message":"调用成功",
"id"：20190953
}
# 返回结果说明
| 序号 | 返回项目 | 返回类型 | 项目说明 |
|---|---|---|---|
| 1 | id | int | 数据集id |
# 返回结果（返回错误）
{
"code":201,
"message":"数据集名称不允许有特殊字符"
}
# 错误码说明
| 序号 | 错误码 | 错误提示信息 |
|---|---|---|
| 1 | 201 | 数据集名称不允许有除下划线、点号、括号以外的其它特殊字符 |
| 3 | 203 | 数据集名称只能2到50个字符 |
| 4 | 204 | 数据集名称不能为空 |
| 5 | 205 | 数据集名称已存在，请重新命名 |
| 6 | 206 | 数据集描述不能超过200字符 |
| 7 | 207 | type参数错误 |
| 8 | 208 | type不能为空 |
| 9 | 209 | pattern参数错误 |
| 10 | 210 | pattern不能为空 |
| 11 | 211 | 单个标签长度不能超过15个字符 |
| 12 | 212 | 标签数量不能超过5个 |