116 lines
3.3 KiB
Java
116 lines
3.3 KiB
Java
package com.ruoyi.jarvis.service;
|
||
|
||
import com.alibaba.fastjson2.JSONObject;
|
||
|
||
import java.util.List;
|
||
import java.util.Map;
|
||
|
||
/**
|
||
* WPS365 API服务接口
|
||
*
|
||
* @author system
|
||
*/
|
||
public interface IWPS365ApiService {
|
||
|
||
/**
|
||
* 获取用户信息
|
||
*
|
||
* @param accessToken 访问令牌
|
||
* @return 用户信息
|
||
*/
|
||
JSONObject getUserInfo(String accessToken);
|
||
|
||
/**
|
||
* 获取文件列表
|
||
*
|
||
* @param accessToken 访问令牌
|
||
* @param params 查询参数（page, page_size等）
|
||
* @return 文件列表
|
||
*/
|
||
JSONObject getFileList(String accessToken, Map<String, Object> params);
|
||
|
||
/**
|
||
* 获取文件信息
|
||
*
|
||
* @param accessToken 访问令牌
|
||
* @param fileToken 文件token
|
||
* @return 文件信息
|
||
*/
|
||
JSONObject getFileInfo(String accessToken, String fileToken);
|
||
|
||
/**
|
||
* 更新单元格数据（KSheet - 在线表格）
|
||
*
|
||
* @param accessToken 访问令牌
|
||
* @param fileToken 文件token
|
||
* @param sheetIdx 工作表索引（从0开始）
|
||
* @param range 单元格范围（如：A1:B2）
|
||
* @param values 单元格值（二维数组，第一维是行，第二维是列）
|
||
* @return 更新结果
|
||
*/
|
||
JSONObject updateCells(String accessToken, String fileToken, int sheetIdx, String range, List<List<Object>> values);
|
||
|
||
/**
|
||
* 读取单元格数据
|
||
*
|
||
* @param accessToken 访问令牌
|
||
* @param fileToken 文件token
|
||
* @param sheetIdx 工作表索引
|
||
* @param range 单元格范围
|
||
* @return 单元格数据
|
||
*/
|
||
JSONObject readCells(String accessToken, String fileToken, int sheetIdx, String range);
|
||
|
||
/**
|
||
* 获取工作表列表
|
||
*
|
||
* @param accessToken 访问令牌
|
||
* @param fileToken 文件token
|
||
* @return 工作表列表
|
||
*/
|
||
JSONObject getSheetList(String accessToken, String fileToken);
|
||
|
||
/**
|
||
* 创建数据表
|
||
*
|
||
* @param accessToken 访问令牌
|
||
* @param fileToken 文件token
|
||
* @param sheetName 工作表名称
|
||
* @return 创建结果
|
||
*/
|
||
JSONObject createSheet(String accessToken, String fileToken, String sheetName);
|
||
|
||
/**
|
||
* 批量更新单元格数据
|
||
*
|
||
* @param accessToken 访问令牌
|
||
* @param fileToken 文件token
|
||
* @param sheetIdx 工作表索引
|
||
* @param updates 更新列表，每个元素包含range和values
|
||
* @return 更新结果
|
||
*/
|
||
JSONObject batchUpdateCells(String accessToken, String fileToken, int sheetIdx, List<Map<String, Object>> updates);
|
||
|
||
/**
|
||
* 读取AirSheet工作表数据
|
||
*
|
||
* @param accessToken 访问令牌
|
||
* @param worksheetId 工作表ID（文件ID）
|
||
* @param range 单元格范围（如：A1:B10，可选）
|
||
* @return 单元格数据
|
||
*/
|
||
JSONObject readAirSheetCells(String accessToken, String worksheetId, String range);
|
||
|
||
/**
|
||
* 更新AirSheet工作表数据
|
||
*
|
||
* @param accessToken 访问令牌
|
||
* @param worksheetId 工作表ID（文件ID）
|
||
* @param range 单元格范围（如：A1:B2）
|
||
* @param values 单元格值（二维数组，第一维是行，第二维是列）
|
||
* @return 更新结果
|
||
*/
|
||
JSONObject updateAirSheetCells(String accessToken, String worksheetId, String range, List<List<Object>> values);
|
||
}
|
||
|