衡石科技BI的产品HENGSHI SENSE API 使用手册 第一篇应用

本文主要是介绍衡石科技BI的产品HENGSHI SENSE API 使用手册 第一篇应用,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

应用说明​

应用针对某一场景创建,它由多个仪表盘组成。 应用包含了用户一次探索所需要的全部数据、图表以及关系模型,非常适合作为日常工作的一个封装概念。

应用的定义​

应用结构说明​
字段类型描述
idLONG应用的 id
titleSTRING应用的标题
optionsOBJECT应用的配置信息
options.dashboardsNUMBER 数组此应用下的仪表盘 id 列表
options.chartsNUMBER 数组此应用下的图表 id 列表
options.datasetsNUMBER 数组此应用下的数据集 id 列表
options.dashboardsOrderNUMBER 数组此应用下的仪表盘的显示顺序
options.enableAppRuleBOOL是否启用行权限控制
options.publishConfigOBJECT此应用的发布设置,只在发布的应用中启用
options.publishConfig.publishTitleSTRING发布的应用标题
options.publishConfig.publisherSTRING发布的用户名
options.publishConfig.coverImageIdNUMBER发布的应用的封面图片 id
options.publishConfig.watermarkImageIdNUMBER发布的应用的水印图片 id
options.publishConfig.duplicatedPermittedBOOL发布的应用是否允许复制数据集
options.publishConfig.showDetailPermittedBOOL只读模式下访问应用是否允许显示详情
options.publishConfig.downloadPermittedBOOL只读模式下访问应用是否允许下载数据
options.publishConfig.zoomInPermittedBOOL只读模式下访问应用是否下钻
options.publishConfig.targetFolderIdLONG发布的目录 id
options.publishConfig.descriptionSTRING发布应用描述
options.publishConfig.foldersTitleSTRING 数组发布的目录路径名称
options.publishConfig.publisherDisplayConfigOBJECT此应用的发布者显示配置
options.publishConfig.publisherDisplayConfig.idLONG发布者 id
options.publishConfig.publisherDisplayConfig.typeSTRING发布者类型
options.publishConfig.publisherDisplayConfig.nameSTRING发布者名称
options.appTemplateUUIDSTRING应用模版的 uuid,只在导入、导出模版用到,不存库
options.filtersOBJECT数组全局过滤器列表
isPublishBOOL应用是不是发布区的应用
publishHashSTRING应用发布的哈希值
publishedByNUMBER发布区应用的源应用 id
folderIdLONG应用所在的文件夹 id
areaSTRING应用所在的区域,可选值参照area值说明
shareHashSTRING分享应用的哈希值
dataModeSTRING应用的数据权限,可选值参照dataMode 值说明
entityGroupSTRING邮件自动推送的执行计划类别,用于管理执行计划,固定为APP_EMAIL
entityKeySTRING邮件自动推送的执行计划关键字,用于管理执行计划
execDetailOBJECT创建邮件推送执行计划需要用到的任务描述信息,详见执行计划
refreshEntityGroupSTRING应用数据集刷新的执行计划类别,用于管理执行计划,固定为APP_REFRESH
refreshExecDetailOBJECT创建数据集刷新执行计划需要用到的任务描述信息,详见执行计划
hsVersionINTEGER可选,本次编辑的版本号,从0开始,修改前先GET待修改资源获取当前版本号,修改时带上刚刚获取的版本号,服务端会检查并发冲突。不带版本号不检查并发冲突。
tenantIdLONG可选, 租户id
typeSTRING应用类型, 可选值参照appType值说明
defaultDatasetLONG可选,应用中用于做图的默认数据集
publishStateBOOL创作区的应用是否发布
latestAuthorizedByLONG应用最近一次的授权者
latestAuthorizedAtDATE应用最近一次授权时间
latestPublishedByLONG应用最近一次的发布者
latestPublishedAtDATE应用最近一次发布时间
area 值说明​
字段值描述
PERSONAL_AREA应用创作区的个人区
PUBLIC_AREA应用创作区的共享区
DATA_MART数据集市
APP_MART应用集市
dataMode 值说明​
字段值描述
APP_MODE应用作者
DATASET_MODE数据集作者
VIEWER_MODE使用者
appType 值说明​
字段值描述
ANALYTIC_APP常用应用,用于分析场景
QUERY_APP查询应用,用于自助查询场景
DATA_APP数据包,用于数据集市区处理数据集
REPORT_APP报表应用

接口说明​

创建应用​

请求URL​

http

POST /api/apps HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
request body 请求体​

应用结构说明

字段类型描述
titleSTRING应用的标题
folderIdLONG应用所在的文件夹 id, 应用创作共享空间的根目录 id 为 1, 数据集市的根目录 id 为 2
areaSTRING应用所在区域,需与folderId对应的目录所在区域一致,默认为PERSONAL_AREA
返回对象的格式说明​

应用结构说明

接口示例1 在应用创作区新建应用​

RequestResponse

http

POST /api/apps HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...// Request Body:
{"title": "应用名称","options": {"dashboardsOrder": [],"themes": {}}
}

接口示例2 在应用创作共享空间根目录下创建应用​

http

POST /api/apps HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...// Request Body:
{"folderId": 1,"title": "应用名称","area": "PULIC_AREA","options": {"dashboardsOrder": [],"themes": {}}
}

接口示例3 在应用集市团队空间根目录下创建应用​

http

POST /api/apps HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...// Request Body:
{"folderId": 2,"title": "应用名称","area": "SYSTEM_PORTAL","options": {"dashboardsOrder": [],"themes": {}}
}

接口示例4 在应用创作下创建自助查询应用​

http

POST /api/apps HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...// Request Body:
{"title": "应用名称","options": {"dashboardsOrder": [],"themes": {}},"type": "QUERY_APP"
}

查询应用​

查询用户能看到的应用列表,在应用集市和应用创作区使用。

请求URL​

http

GET /api/apps HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
URL 参数​
字段类型是否必须说明
publishBOOLEAN获取应用集市区应用时设置为 true,获取应用协作区应用时设置为 false
orderByString排序字段
pOrCByCurrentBOOLEAN应用集市区,查询 "我发布的" 应用时设置为 true, "发布给我的" 应用时设置为 false;应用协作区,查询"我协作的" 应用时设置为 true, "协作给我的" 应用时设置为 false
createdByCurrentBOOLEAN查询 "我创建的" 应用时设置为 true,"协作给我的" 应用时设置为false,用于应用创作区
showHideBOOLEAN是否显示隐藏的应用,用于应用集市区
queryAllBOOLEAN是否显示全部应用
idsString要查询的应用id列表,用逗号隔开如:1,2,3,4
返回对象的格式说明​

应用结构说明

接口示例1​

RequestResponse

http

GET /api/apps?pOrCByCurrent=false&offset=0&limit=20&orderBy=updatedAt&orderType=desc HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

根据ID查询应用​

请求URL​

http

GET /api/apps/{appId} HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
URL 参数​
字段类型是否必须说明
appIdINTEGER指定应用的 id
checkStatusBOOLEAN是否检查发布态应用的状态,若为true且发布态应用处于暂停服务状态,则报错
返回对象的格式说明​

应用结构说明

接口示例1 查询 id 为 1 的应用​

RequestResponse

http

GET /api/apps/1 HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

更新应用​

请求URL​

http

PUT /api/apps/{appId} HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
URL 参数​
字段类型是否必须说明
appIdINTEGER指定应用的 id
request body 请求体​

应用结构说明, 可以被修改的内容见下表:

字段类型描述
titleSTRING应用的标题
options.enableAppRuleBOOL是否启用行权限控制
options.publishConfig.showDetailPermittedBOOL只读模式下访问应用是否允许显示详情
options.publishConfig.downloadPermittedBOOL只读模式下访问应用是否允许下载数据
options.publishConfig.zoomInPermittedBOOL只读模式下访问应用是否下钻
dataModeSTRING应用的数据权限,可选值参照dataMode 值说明
folderIdLONG应用目录id,若与当前不一致,则视为移动应用操作,会检查是否可移动与权限
返回对象的格式说明​

应用结构说明

接口示例1 更新 id 为 1 的应用标题​

http

PUT /api/apps/1 HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...// Request Body:
{"title": "wewe","hsVersion": 1
}

接口示例2 启用 id 为 1 的应用行权限规则​

http

PUT /api/apps/1 HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...// Request Body:
{"dataMode": "APP_MODE","options": {"dashboards": [1,2],"datasets": [7],"dashboardsOrder": [1,2],"enableAppRule": true,"publishConfig": {"zoomInPermitted": true,"showDetailPermitted": true,"downloadPermitted": true,"totalPages": {},"duplicatedPermitted": false}},"hsVersion": 1
}

删除应用​

请求URL​

http

DELETE /api/apps/{appId} HTTP/1.1

请求参数​
URL 参数​
字段类型是否必须说明
appIdINTEGER指定应用的 id
返回对象的格式说明​
字段类型说明
versionSTRING当前系统版本哈希值
msgSTRING成功返回 success

运行图表获取数据​

根据图表配置信息获取图表数据。

请求URL​

http

POST /api/apps/{appId}/chart-data HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
URL 参数​
字段类型说明
appIdNUMBER必填
Request Body 参数​

图表的配置信息,详见图表结构说明

返回对象的格式说明​

数据集数据 datasetResultDto

接口示例1​

以下是一个按{region_name}做分组,用sum({region_id})做度量的一个数据请求。[Request]中的GROUP函数可以省略,如果是同一个数据集那么dataset: 3这个描述可以省略。纯数据查询这样的请求可以发送为[Request1][Request2]这样的简化形式:

RequestRequest2Request3Response

http

POST /api/apps/1/chart-data HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...// Request Body:
{"datasetId": 3,"options": {"axes": [{"op": "group","uid": "u_edbee8adba68e26a_0","kind": "function","args": [{"kind": "field","op": "region_name","dataset": 3}]},{"op": "sum","uid": "u_9f886f9cb7bdf1d2_1","kind": "function","args": [{"kind": "field","op": "region_id","dataset": 3}]}]}
}

运行图表获取原始数据​

根据图表配置信息获取图表用到的数据集的原始数据。

请求URL​

http

POST /api/apps/{appId}/chart-related-data HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
URL 参数​
字段类型说明
appIdNUMBER必填
Request Body 参数​

图表的配置信息,详见图表结构说明

返回对象的格式说明​

数据集数据 datasetResultDto

接口示例1​

RequestResponse

http

POST /api/apps/1/chart-related-data HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...// Request Body:
{"datasetId": 3,"options": {"axes": [{"op": "group","uid": "u_edbee8adba68e26a_0","kind": "function","args": [{"kind": "field","op": "region_name","dataset": 3}]},{"op": "sum","uid": "u_9f886f9cb7bdf1d2_1","kind": "function","args": [{"kind": "field","op": "region_id","dataset": 3}]}],"fieldsPolicy": "AXES_ALL"}
}

分页查询回收站中的应用​

查询不同区域下回收站中的应用

请求URL​

http

GET /api/list-trash HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
URL 参数​
字段类型说明
area枚举可选,有效值参照area值说明,默认是 PERSONAL_AREA
orderBySTRING可选,排序字段,默认是按照更新时间降序排序
orderTypeSTRING可选,排序类型,asc - 表示升序,desc - 表示降序
limitNUMBER可选,单页限制条数,默认是10
offsetNUMBER可选,页数偏移量,默认是0
返回对象的格式说明​

app对象的数组。

接口示例1​

RequestResponse

http

GET /api/list-trash?area=PERSONAL_AREA HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

恢复回收站中的应用​

恢复回收站中的应用

请求URL​

http

POST /api/apps/{appId}/restore HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
URL 参数​
字段类型说明
appIdINTEGER指定要恢复的应用 id
接口示例1​

RequestResponse

http

POST /api/apps/1664/restore HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

彻底删除回收站中的应用​

彻底删除回收站中的应用

请求URL​

http

POST /api/apps/{appId}/prune HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
URL 参数​
字段类型说明
appIdINTEGER指定要恢复的应用 id
接口示例1​

RequestResponse

http

POST /api/apps/1664/prune HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

在当前app下用HE 查询数据​

在当前app下用 HE 语句查询数据

请求URL​

http

POST /api/apps/{appId}/query HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

URL 请求参数​

| appId | NUMBER | 必填,应用的 id | | limit | NUMBER | 可选,返回记录的最大条数,默认是1000 | | offset | NUMBER | 可选,返回第几页数据,默认是0 |

Request Body 参数​

HE 表达式,详情参照HE 的数据集函数

返回对象的格式说明​

数据集数据 datasetResultDto

参考示例​

RequestResponse

http

POST /api/apps/1/query HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...// Request Body:
{"kind": "formula","op": "summarize(dataset(1), {type}, sum({votes}) as 'sum1')"
}

批量隐藏 & 排序仪表盘​

批量隐藏 & 排序仪表盘

请求URL​

http

PUT /api/apps/{appId}/update-dashbords-order-hide HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
Request Body 参数​

json

{"options": {"dashboardsOrder": [1,2,3]},"resourceBatchUpdateDtos": [{"ids": [1],"pathAndValues": [{"path": ["hide"],"value": false}]},{"ids": [2,3],"pathAndValues": [{"path": ["hide"],"value": true}]}]
}

接口示例1​

RequestResponse

http

PUT /api/apps/{appId}/update-dashbords-order-hide HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...// Request Body:
{"options": {"dashboardsOrder": [1,2,3]},"resourceBatchUpdateDtos": [{"ids": [1],"pathAndValues": [{"path": ["hide"],"value": false}]},{"ids": [2,3],"pathAndValues": [{"path": ["hide"],"value": true}]}],"hsVersion": 5
}

上传封面​

请求URL​

http

PUT /api/apps/{appId}/cover HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
Request Body 参数​

表单数据

后端API请求代码样例​

java

@Test
public void uploadTest()throws Exception{SimpleClientHttpRequestFactory simpleClientHttpRequestFactory=new SimpleClientHttpRequestFactory();simpleClientHttpRequestFactory.setConnectTimeout(15000);simpleClientHttpRequestFactory.setReadTimeout(5000);RestTemplate restTemplate=new RestTemplate(simpleClientHttpRequestFactory);HttpHeaders headers=new HttpHeaders();headers.setContentType(MediaType.MULTIPART_FORM_DATA);headers.set("Cookie","csrf=142b7fd3-2cbf-4caa-ace5-480ad9871623; sid=3aadc6f7-67ea-49d7-8ec1-de4bb7ef673b");headers.set("X-CSRF-Token","142b7fd3-2cbf-4caa-ace5-480ad9871623");String url="/api/apps/47/cover";FileSystemResource fileSystemResource=new FileSystemResource("/Users/hengshi/Documents/a.jpg");MultiValueMap<String, Object> form=new LinkedMultiValueMap<>();form.add("file",fileSystemResource);form.add("filename","a.jpg");HttpEntity<MultiValueMap<String, Object>>files=new HttpEntity<>(form,headers);String s=restTemplate.postForObject(url,files,String.class);}

返回对象的格式说明​
字段类型说明
versionSTRING当前系统版本哈希值
dataINTEGER图片的 id

上传水印​

请求URL​

http

PUT /api/apps/{appId}/watermark HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
Request Body 参数​

表单数据

后端API请求代码样例​

后端API请求代码样例

返回对象的格式说明​
字段类型说明
versionSTRING当前系统版本哈希值
dataINTEGER图片的 id

发布应用​

请求URL​

http

POST /api/apps/{appId}/publish HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
url 参数​
字段类型描述
appIdINTEGER应用的 id
request body 请求体​

应用结构说明,只涉及到 options.publishConfig 实体

返回对象的格式说明​

应用结构说明

接口示例1 在应用创作区新建应用​

RequestResponse

http

POST /api/apps/1/publish HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...// Request Body:
{"targetFolderId": 2805,"targetArea": "SYSTEM_PORTAL","options": {"publishConfig": {"publishTitle": "0529-3.1-app","publisher": "trial","coverImageId": 102,"watermarkImageId": 103,"zoomInPermitted": true,"showDetailPermitted": true,"downloadPermitted": true,"duplicatedPermitted": true,"targetFolderId": 1,"description": "app description","foldersTitle": ["公共空间","文件夹"],"publisherDisplayConfig": {"id": 123,"type": "user","name": "trial"}}}
}

取消发布​

取消发布

请求URL​

http

DELETE /api/apps/{appId}/publish/cancel HTTP/1.1

1

请求参数​

request body 参数​

返回对象的格式说明​
字段类型说明
versionSTRING当前系统版本哈希值
说明​

该操作只能由应用的创建者执行

接口示例1: 取消发布​

RequestResponse

http

DELETE /api/apps/{appId}/publish/cancel HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

查看应用中使用的数据连接​

请求URL​

http

GET /api/apps/{appId}/connection-replace HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
url 参数​
字段类型描述
appIdINTEGER应用的 id
返回对象的格式说明​

返回对象是dataset list,每个dataset里带有connection的信息。

字段类型描述
idNUMBER数据集的 id
options.connectionIdNUMBER数据连接的 id
options.connectionTitleNUMBER数据连接的标题
options.originSTRING数据连接的类型
接口示例1 列出应用 1 中图表所用到的所有数据连接​

RequestResponse

http

GET /api/apps/1/connection-replace HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

替换应用中使用的数据连接​

请求URL​

http

POST /api/apps/{appId}/connection-replace HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
url 参数​
字段类型描述
appIdINTEGER应用的 id
request body 请求体​

现在使用的数据连接 id 和要替换的数据连接 id 对应关系的列表。例如:[{"current":4197,"replace":4122}]

返回对象的格式说明​
字段类型描述
msgSTRING执行成功返回 success
接口示例1 替换应用 1 中图表所用到的一个数据连接​

RequestResponse

http

POST /api/apps/1/connection-replace HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...// Request Body:
[{"current": 4197,"replace": 4122}
]

查看应用中使用的数据包​

请求URL​

http

GET /api/apps/{appId}/dataapp-replace HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
url 参数​
字段类型描述
appIdINTEGER应用的 id
返回对象的格式说明​
字段类型描述
idNUMBER应用的 id
titleSTRING应用的标题
areaSTRING应用所在的区域,可选值参照area值说明
parentsOBJECT 数组应用所在的文件夹列表,顺序是从外层目录到里层目录
parents.[].idNUMBER文件夹的id
parents.[].titleSTRING文件夹的标题
parents.[].areaSTRING文件夹所在的区域
接口示例1 列出应用 1 中图表所用到的所有数据包​

RequestResponse

http

GET /api/apps/1/dataapp-replace HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

替换应用中使用的数据包​

请求URL​

http

POST /api/apps/{appId}/dataapp-replace HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
url 参数​
字段类型描述
appIdINTEGER应用的 id
request body 请求体​

现在使用的数据包 id 和要替换的数据包 id 对应关系的列表。例如:[{"current":3376,"replace":154}]

返回对象的格式说明​
字段类型描述
msgSTRING执行成功返回 success
接口示例1 替换应用 1 中图表所用到的一个数据包​

RequestResponse

http

POST /api/apps/1/dataapp-replace HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...// Request Body:
[{"current": 3376,"replace": 154}
]

全部禁用应用中的单个数据集更新计划​

请求URL​

http

POST /api/apps/{appId}/disable-all-dataset-schedule HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
url 参数​
字段类型描述
appIdINTEGER应用的 id
request body 请求体​
返回对象的格式说明​
字段类型描述
msgSTRING执行成功返回 success
接口示例1 禁用app id为1的所有单个数据集更新计划​

RequestResponse

http

POST /api/apps/1/disable-all-dataset-schedule HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...// Request Body:
{}

应用刷新时排除这个数据集​

请求URL​

http

POST /api/apps/{appId}/exclude-in-app-refresh HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
url 参数​
字段类型描述
appIdINTEGER应用的 id
request body 请求体​
字段类型描述
entityKeySTRING被排除的数据集的执行计划的entityKey,不包含这个字段,表示全部
返回对象的格式说明​
字段类型描述
msgSTRING执行成功返回 success
接口示例1 禁用app id为1的所有单个数据集更新计划​

RequestResponse

http

POST /api/apps/1/exclude-in-app-refresh HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...// Request Body:
{"entityKey": "1-1"
}

应用刷新时包含这个数据集​

请求URL​

http

POST /api/apps/{appId}/include-in-app-refresh HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
url 参数​
字段类型描述
appIdINTEGER应用的 id
request body 请求体​
字段类型描述
entityKeySTRING被包含的数据集的执行计划的entityKey,不包含这个字段,表示全部
返回对象的格式说明​
字段类型描述
msgSTRING执行成功返回 success
接口示例1 禁用app id为1的所有单个数据集更新计划​

RequestResponse

http

POST /api/apps/1/include-in-app-refresh HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...// Request Body:
{"entityKey": "1-1"
}

查询应用中单个数据的执行计划列表​

请求URL​

http

GET /api/apps/{appId}/dataset-schedules HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
URL 参数​
字段类型是否必须说明
appIdINTEGER应用的 id
includeInAppScopeBOOL可选本dataset是否包括在app scope刷新中
qSTRING可选搜索关键字
返回对象的格式说明​

和查询执行计划列表 返回数据一致,多一个字段:

字段类型是否必须说明
includeInAppScopeBOOL可选本dataset是否包括在app scope刷新中
接口示例1​

RequestResponse

http

GET /api/apps/1/dataset-schedules HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

查询应用刷新的执行计划​

请求URL​

http

GET /api/apps/{appId}/refresh-schedule HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
URL 参数​
字段类型是否必须说明
appIdINTEGER应用的 id
返回对象的格式说明​

和查询执行计划列表 返回数据一致,只有一个执行计划object

接口示例1​

RequestResponse

http

GET /api/apps/1/refresh-schedule HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

创建自助查询应用的用户设置​

请求URL​

http

GET /api/apps/{appId}/profiles HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
URL 参数​
字段类型是否必须说明
appIdINTEGER应用的 id
返回对象的格式说明​

和查询执行计划列表 返回数据一致,只有一个执行计划object

接口示例1​

RequestResponse

http

GET /api/apps/1/refresh-schedule HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

复制应用​

请求URL​

http

POST /api/apps/{appId}/duplicate HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
url 参数​
字段类型描述
appIdINTEGER应用的 id
request body 请求体​
字段类型描述
targetFolderIdLONG复制到目录的id,不包含这个字段,表示和源应用同一目录
titleString新应用名称,可不传
返回对象的格式说明​

应用结构说明

接口示例1 在应用创作区创建应用副本​

RequestResponse

http

POST /api/apps/1/duplicate HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

接口示例2 在应用集市区使用模版新建应用​

http

POST /api/apps/2/duplicate HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

  1. 响应结果 和接口示例1返回数据一致
接口示例3 在应用创作区将应用复制到指定目录下​

http

POST /api/apps/3/duplicate HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...// Request Body:
{"targetFolderId": 0,"title": "duplicate app"
}

  1. 响应结果 和接口示例1返回数据一致

使用模板覆盖当前应用​

请求URL​

http

POST /api/apps/{appId}/overwrite HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
url 参数​
字段类型描述
appIdINTEGER应用的 id
fileBINARY必填, 模版文件流
copyBOOLEAN必填, 是否备份当前应用
overwriteAuthBOOLEAN非 必填, 是否覆盖当前应用的权限配置
返回对象的格式说明​

应用结构说明

接口示例1 使用模板覆盖当前应用​

RequestResponse

http

POST /api/apps/1/overwrite?copy=false HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

暂停/恢复APP​

请求URL​

http

POST /api/apps/{appId}/pending HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
url 参数​
字段类型描述
appIdINTEGER应用的 id
statusSTRING必填, 要修改的应用状态,可选值:PENDING
返回对象的格式说明​

应用结构说明

接口示例1 使用模板覆盖当前应用​

RequestResponse

http

POST /api/apps/1/pending?status=pending HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

GET 获取指定用户创建的所有APP​

获取指定用户创建的所有APP。针对SYSTEM_PORTAL、PUBLIC_AREA、DATA_MART的中的APP需要当前发起请求的用户拥有系统管理员以及数据管理员角色,当请求中显示指定了用户时则返回指定用户创建的所有应用,否则返回当前用户创建的所有应用。当指定非当前用户时, area取值只能是 SYSTEM_PORTAL | PUBLIC_AREA | DATA_MART之一。

请求参数​
名称位置类型必选说明
createdByqueryinteger指定用户ID
creatorEmailqueryinteger指定用户绑定电子邮箱
creatorMobilequeryinteger指定用户绑定手机号码
creatorLoginNamequeryinteger指定用户登陆名
areaquerystring指定区域,可选项:SYSTEM_PORTAL、PUBLIC_AREA、DATA_MART、PERSONAL_AREA、APP_MART
orderByquerystring排序字段
orderTypequerystring排序方式
offsetquerystring分页偏移量
limitquerystring分页大小

RequestResponse

http

GET /api/apps/created-list?area=SYSTEM_PORTAL&orderBy=createdAt&orderType=desc&offset=0&limit=10 HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

返回结果​
状态码状态码含义说明数据模型
200OK成功Inline
返回数据结构​

状态码 200

名称类型必选约束中文名说明
» codeintegertruenonenone
» msgstringtruenonenone
» data[object]truenonenone
»» idintegertruenonenone
»» titlestringtruenonenone
»» coverstringtruenonenone
»» optionsobjecttruenonenone
»»» dashboardsOrder[string]truenonenone
»»» enableRuleStrictValidatebooleantruenonenone
»»» devicesobjecttruenonenone
»»»» pcbooleantruenonenone
»»»» mobilebooleantruenonenone
»» createdByintegertruenonenone
»» createdAtstringtruenonenone
»» updatedByintegertruenonenone
»» updatedAtstringtruenonenone
»» latestAuthorizedByintegertruenonenone
»» latestAuthorizedAtstringtruenonenone
»» visiblebooleantruenonenone
»» isDeletebooleantruenonenone
»» isPublishbooleantruenonenone
»» isBackupbooleantruenonenone
»» folderIdintegertruenonenone
»» areastringtruenonenone
»» dataModestringtruenonenone
»» emailOptionsobjecttruenonenone
»» typestringtruenonenone
»» publishStatebooleantruenonenone
»» hideDatasets[integer]truenonenone
»» statusstringtruenonenone
»» creatorobjecttruenonenone
»»» idintegertruenonenone
»»» namestringtruenonenone
»»» emailstringtruenonenone
»»» loginNamestringtruenonenone
»» updaterobjecttruenonenone
»»» idintegertruenonenone
»»» namestringtruenonenone
»»» emailstringtruenonenone
»»» loginNamestringtruenonenone
»» refreshExecDetailobjecttruenonenone
»»» jobClassstringtruenonenone
»»» jobParamsobjecttruenonenone
»»»» appintegertruenonenone
»»» retryTimesintegertruenonenone
»» refreshEntityGroupstringtruenonenone
»» entityKeystringtruenonenone
»» entityGroupstringtruenonenone
»» execDetailobjecttruenonenone
»»» jobClassstringtruenonenone
»»» jobParamsobjecttruenonenone
»»»» appintegertruenonenone
»»» retryTimesintegertruenonenone
» totalHitsintegertruenonenone
» offsetintegertruenonenone
» chartDataStartTimeMillisintegertruenonenone

应用/应用版本管理​

GET 获取应用备份版本个数​

查询当前app应用备份版本个数。

请求参数​
名称位置类型必选说明
appIdpathstringnone

RequestResponse

http

GET /api/apps/{appId}/backups/count HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

返回结果​
状态码状态码含义说明数据模型
200OK成功Inline
返回数据结构​

状态码 200

名称类型必选约束中文名说明
» versionstringtruenonenone
» codeintegertruenonenone
» msgstringtruenonenone
» dataintegertruenonenone
» chartDataStartTimeMillisintegertruenonenone

GET 获取应用备份列表​

查询当前app备份信息。

请求参数​
名称位置类型必选说明
appIdpathstringnone
orderByquerystringnone
limitquerystringnone
orderTypequerystringnone
offsetquerystringnone

RequestResponse

http

GET /api/apps/{appId}/backups HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

返回结果​
状态码状态码含义说明数据模型
200OK成功Inline
返回数据结构​

状态码 200

名称类型必选约束中文名说明
» versionstringtruenonenone
» codeintegertruenonenone
» msgstringtruenonenone
» data[object]truenonenone
»» idintegertruenonenone
»» appIdintegertruenone当前应用id
»» backupAppIdintegertruenone备份应用id
»» titlestringtruenone备份记录标题
»» createdByintegertruenone备份记录创建者
»» createdAtstringtruenone备份记录创建时间
»» updatedByintegertruenone备份记录最后一次修改者
»» updatedAtstringtruenone备份记录最后一次修改时间
»» isDeletedbooleantruenonenone
»» creatorobjecttruenonenone
»»» idintegertruenonenone
»»» namestringtruenonenone
»»» loginNamestringtruenonenone
»» updaterobjecttruenonenone
»»» idintegertruenonenone
»»» namestringtruenonenone
»»» loginNamestringtruenonenone
» chartDataStartTimeMillisintegertruenonenone

DELETE 删除备份​

删除指定的app的指定备份文件。

请求参数​
名称位置类型必选说明
appIdpathstring应用id
backupIdpathstring应用备份记录id

RequestResponse

http

DELETE /api/apps/{appId}/backups/{backupId} HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

返回结果​
状态码状态码含义说明数据模型
200OK成功Inline
返回数据结构​

PUT 更新备份记录信息​

更新指定app的指定备份记录信息。更新的是备份记录信息,并不是副本本身。

请求参数​
名称位置类型必选说明
appIdpathstring应用id
backupIdpathstring应用备份记录id
bodybodyobjectnone
» titlebodystringnone

RequestResponse

http

PUT /api/apps/{appId}/backups/{backupId} HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...// Request Body:
{"title": "1号备份"
}

返回结果​
状态码状态码含义说明数据模型
200OK成功Inline
返回数据结构​

GET 重置​

http

GET /api/apps/{appId}/backups/{backupId}/restore HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

1
2
3

将指定app重置到指定的备份版本。

说明

应用版本仅保留数据分析相关的所有内容:仪表盘、数据集、数据模型、参数、翻页器等,涉及到连接、权限相关的设置则无法保留。 应用发布时自动保留版本,仅保留最近的若干版本。更早的版本将被自动删除。

请求参数​
名称位置类型必选说明
appIdpathstringnone
backupIdpathstringnone
返回结果​
状态码状态码含义说明数据模型
200OK成功Inline
返回数据结构​

应用/导入导出​

GET 导出应用模板​

http

GET /api/apps/{appId}/export-template HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
名称位置类型必选说明
appIdpathstringnone
exportAuthquerystring要导出的模版版本,若要将模版导入3.6或3.6之前的系统,则需要传3.6
tplVersionquerystring是否要导出应用的授权 & 权限模式 & 行权限信息,个人区需应用作者才能导出,公共区需应用管理员才能导出
返回结果​
状态码状态码含义说明数据模型
200OK成功Inline
返回数据结构​

POST 校验应用模板​

在导入模板之前应先调用该API对要进行导入的模板文件进行校验。

请求参数​
名称位置类型必选说明
areaquerystring目标区域

RequestResponse

http

POST /api/apps/import-template-validate HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

返回结果​
状态码状态码含义说明数据模型
200OK成功Inline
400Bad Request模板中存在错误Inline
返回数据结构​

POST 导入模板​

根据导入的模板文件创建app。

http

POST /api/apps/import-template HTTP/1.1
Accept: application/json
Content-Type: multipart/form-data; boundary=----WebKitFormBoundarywj9aABghi7jHeyqX
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...file:
------WebKitFormBoundarywj9aABghi7jHeyqX
Content-Disposition: form-data; name="file"; filename="HengShi App.hstpl"
Content-Type: application/octet-stream
------WebKitFormBoundarywj9aABghi7jHeyqX--

请求参数​
名称位置类型必选说明
folderIdquerystring可选, 文件夹id,如果为空,就导入个人区
importAuthquerystring是否导入应用授权 & 权限模式 & 行权限信息
bodybodyobjectnone
» filebodystring(binary)模板文件
返回结果​
状态码状态码含义说明数据模型
200OK成功Inline
返回数据结构​

POST 使用模板替换应用​

使用提供的模板替换指定应用。

http

POST /api/apps/{appId}/overwrite HTTP/1.1
Accept: application/json
Content-Type: multipart/form-data; boundary=----WebKitFormBoundarywj9aABghi7jHeyqX
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...file:
------WebKitFormBoundarywj9aABghi7jHeyqX
Content-Disposition: form-data; name="file"; filename="HengShi App.hstpl"
Content-Type: application/octet-stream
------WebKitFormBoundarywj9aABghi7jHeyqX--

请求参数​
名称位置类型必选说明
appIdpathstringnone
copyquerystring是否同时创建副本
overwriteAuthquerystring是否覆盖权限配置信息
bodybodyobjectnone
» filebodystring(binary)模板文件
返回结果​
状态码状态码含义说明数据模型
200OK成功Inline
返回数据结构​

应用/批量操作​

批量操作有以下几种类型:​

  • 普通操作
    1. move
    2. delete
    3. update
    4. visible
  • 文件导出操作
    1. export-template

所有类型在批量操作预检查API中均可用,在具体执行批量操作的接口中会有区分。

说明

普通操作只能在'批量操作'API中使用。 文件导出操作只能在'批量导出操作'API中使用。

各操作支持执行对象​

说明

每一种操作并不一定对所有的对象就支持,特定的对象只支持特定的操作。

下面列出每一种对象支持的操作:

/folderappdatasetchartdashboardfieldmetricapp param
moveyy//////
deleteyy///yyy
update/////yy/
visible/////y//
export-template/y//////

POST 批量操作预检查​

执行批量操作之前,调用该API对该操作进行合法性校验。

http

POST /api/batch/check/{batch-operation} HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...// Request Body:
{"items": [{"objectType": "app","idSet": [112326,129220]}],"args": {"tplVersion": "4.5","exportAuth": true}
}

请求参数​
名称位置类型必选说明
batch-operationpathstring批量操作类型
bodybodyobjectnone
» itemsbody[object]批量操作对象列表
»» objectTypebodystring批量操作对象类型
»» idSetbody[string]批量操作对象唯一标识集合
» argsbodyobject批量操作额外变量
»» tplVersionbodystringnone
»» exportAuthbodybooleannone
返回结果​
状态码状态码含义说明数据模型
200OK成功Inline
返回数据结构​

POST 批量导出操作​

http

POST /api/batch/export/{export-operation} HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...// Request Body:
{"items": [{"objectType": "app","idSet": [112326,129220]}],"args": {"tplVersion": "4.5","exportAuth": true}
}

请求参数​
名称位置类型必选说明
export-operationpathstring批量导出操作
bodybodyobjectnone
» itemsbody[object]none
»» objectTypebodystringnone
»» idSetbody[string]none
» argsbodyobjectnone
»» tplVersionbodystringnone
»» exportAuthbodybooleannone
返回结果​
状态码状态码含义说明数据模型
200OK成功Inline
返回数据结构​

POST 批量操作​

执行批量操作

请求参数​
名称位置类型必选说明
batch-operationpathstring批量操作类型
bodybodyobjectnone
» itemsbody[object]none
»» objectTypebodystringnone
»» idSetbody[string]none
» argsbodyobjectnone
»» targetIdbodyintegernone
»» keepAuthbodybooleannone

RequestResponse

http

POST /api/batch/operation/{batch-operation} HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...// Request Body:
{"items": [{"objectType": "app","idSet": [129052]}],"args": {"targetId": 3270,"keepAuth": false}
}

返回结果​
状态码状态码含义说明数据模型
200OK成功Inline
返回数据结构​

状态码 200

名称类型必选约束中文名说明
» codeintegertruenonenone
» msgstringtruenonenone
» dataobjecttruenonenone
»» items[object]truenonenone
»»» objectTypestringfalsenonenone
»»» successIdSet[integer]falsenonenone
» chartDataStartTimeMillisintegertruenonenone

衡石文档相关参考资料:应用

这篇关于衡石科技BI的产品HENGSHI SENSE API 使用手册 第一篇应用的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1114545

相关文章

Java调用DeepSeek API的最佳实践及详细代码示例

《Java调用DeepSeekAPI的最佳实践及详细代码示例》:本文主要介绍如何使用Java调用DeepSeekAPI,包括获取API密钥、添加HTTP客户端依赖、创建HTTP请求、处理响应、... 目录1. 获取API密钥2. 添加HTTP客户端依赖3. 创建HTTP请求4. 处理响应5. 错误处理6.

Deepseek R1模型本地化部署+API接口调用详细教程(释放AI生产力)

《DeepseekR1模型本地化部署+API接口调用详细教程(释放AI生产力)》本文介绍了本地部署DeepSeekR1模型和通过API调用将其集成到VSCode中的过程,作者详细步骤展示了如何下载和... 目录前言一、deepseek R1模型与chatGPT o1系列模型对比二、本地部署步骤1.安装oll

浅析如何使用Swagger生成带权限控制的API文档

《浅析如何使用Swagger生成带权限控制的API文档》当涉及到权限控制时,如何生成既安全又详细的API文档就成了一个关键问题,所以这篇文章小编就来和大家好好聊聊如何用Swagger来生成带有... 目录准备工作配置 Swagger权限控制给 API 加上权限注解查看文档注意事项在咱们的开发工作里,API

一分钟带你上手Python调用DeepSeek的API

《一分钟带你上手Python调用DeepSeek的API》最近DeepSeek非常火,作为一枚对前言技术非常关注的程序员来说,自然都想对接DeepSeek的API来体验一把,下面小编就来为大家介绍一下... 目录前言免费体验API-Key申请首次调用API基本概念最小单元推理模型智能体自定义界面总结前言最

JAVA调用Deepseek的api完成基本对话简单代码示例

《JAVA调用Deepseek的api完成基本对话简单代码示例》:本文主要介绍JAVA调用Deepseek的api完成基本对话的相关资料,文中详细讲解了如何获取DeepSeekAPI密钥、添加H... 获取API密钥首先,从DeepSeek平台获取API密钥,用于身份验证。添加HTTP客户端依赖使用Jav

C#使用DeepSeek API实现自然语言处理,文本分类和情感分析

《C#使用DeepSeekAPI实现自然语言处理,文本分类和情感分析》在C#中使用DeepSeekAPI可以实现多种功能,例如自然语言处理、文本分类、情感分析等,本文主要为大家介绍了具体实现步骤,... 目录准备工作文本生成文本分类问答系统代码生成翻译功能文本摘要文本校对图像描述生成总结在C#中使用Deep

5分钟获取deepseek api并搭建简易问答应用

《5分钟获取deepseekapi并搭建简易问答应用》本文主要介绍了5分钟获取deepseekapi并搭建简易问答应用,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需... 目录1、获取api2、获取base_url和chat_model3、配置模型参数方法一:终端中临时将加

使用DeepSeek API 结合VSCode提升开发效率

《使用DeepSeekAPI结合VSCode提升开发效率》:本文主要介绍DeepSeekAPI与VisualStudioCode(VSCode)结合使用,以提升软件开发效率,具有一定的参考价值... 目录引言准备工作安装必要的 VSCode 扩展配置 DeepSeek API1. 创建 API 请求文件2.

JavaScript中的isTrusted属性及其应用场景详解

《JavaScript中的isTrusted属性及其应用场景详解》在现代Web开发中,JavaScript是构建交互式应用的核心语言,随着前端技术的不断发展,开发者需要处理越来越多的复杂场景,例如事件... 目录引言一、问题背景二、isTrusted 属性的来源与作用1. isTrusted 的定义2. 为

Python调用另一个py文件并传递参数常见的方法及其应用场景

《Python调用另一个py文件并传递参数常见的方法及其应用场景》:本文主要介绍在Python中调用另一个py文件并传递参数的几种常见方法,包括使用import语句、exec函数、subproce... 目录前言1. 使用import语句1.1 基本用法1.2 导入特定函数1.3 处理文件路径2. 使用ex