# API数据源使用示例

## 调用示例代码

```java
Authentication authentication = new Authentication("#key", "#secret");
DatasourceOperation operation = new DatasourceOperation(authentication);
operation.open();
// 创建一个分组，如果已经存在，则直接跳过
operation.createGroup("TestGroup");
// 在分组下创建一个表，返回创建的表的ID，如果表已经存在，则直接返回表ID
String tableId = operation.createTable("HelloTable", "TestGroup");
// 获取上传文件的url
String fileUploadUrl = operation.requestUploadUrl(tableId);
// 将数据文件上传
HttpKits.upload(fileUploadUrl, new File(System.getProperty("user.dir") + "/data/地区数据分析.csv"));
// 标记该表的数据已经上传完成
operation.markAsFinish(tableId);

```

## API文档

### 开启API数据源
#### 查看状态	
请求地址：/api/v1/datasource/status	

请求类型：POST

返回值： 
```json 
{
"success":true,
"code":"200",
"data":{"status":"0"}
}
```

#### 修改状态	
请求地址：/api/v1/datasource/status/modify

请求类型：POST	

请求参数： ``` {"status":"1"} ```

返回值：
```json
{
"success":true,
"code":"200"
}
```

### 分组管理
#### 创建分组	
请求地址：/api/v1/datasource/group/create	

请求类型：POST	

请求参数：{"name":"#分组名"}

#### 读取所有分组	
请求地址：/api/v1/datasource/group/list	

请求类型：POST

### 表管理
#### 创建数据源表	
请求地址：/api/v1/datasource/table/create

请求类型：POST

请求参数： ``` {"group":"#分组名", "name":"#表名"} ```，分组名可以不传，默认值为“默认”


#### 获取表数据上传地址	
请求地址：/api/v1/datasource/table/upload/url	

请求类型：POST

请求参数：``` {"tableId":"#表Id"} ```

#### 标记表数据已上传完成	
请求地址：/api/v1/datasource/table/upload/finish

请求类型：POST	

请求参数：``` {"tableId":"#表Id"} ```