day11
今日新增接口:
- 查询变量
- 查询材料
- 查询模板内容
- 更新模板内容
调整zip文件上传逻辑,现在保存整个目录层级,目录的fileid为null,增加parentfileId字段标识父节点
注意操作哪个表就将方法写到哪一个service下
注意返回值的规范化,统一采用Result
格式为{
code:
message:
data:
timestamp:
}
3.9 查询变量
接口地址:
l 接口地址:/api/generateEdit/searchGenerations
l 请求方式:GET
l Content-Type:application/json
l 响应类型:非流式响应
3.9.1 请求参数
| *字段名* | *类型* | *说明* | *字段名* |
|---|---|---|---|
| *projectId* | *Long* | *是* | *项目ID* |
请求示例:
curl --location --request GET 'https://bz-ai-server-dev.maas.com.cn/fjreportapi/api/generateEdit/searchGenerations?projectId=63' \
--header 'User-Agent: Apifox/1.0.0 (https://apifox.com)' \
--header 'Accept: /' \
--header 'Host: bz-ai-server-dev.maas.com.cn' \
--header 'Connection: keep-alive'
3.9.2 响应参数
| *字段名* | *类型* | *说明* |
|---|---|---|
| *code* | *integer* | *状态码,例如 200 代表成功。* |
| *message* | *string* | *操作结果的描述信息,例如 "操作成功"。* |
| *data* | *object* | *核心业务数据对象* |
| *timestamp* | *long* | *服务器响应时的时间戳。* |
这是 data 数组中每个元素(项目)的详细字段。
| *参数名称* | *类型* | *说明* |
|---|---|---|
| *structureId* | *integer* | *项目ID**。* |
| *structureName* | *String* | *项目名称**。* |
| *parentId* | *Integer* | *父项目ID* |
| *level* | *Integer* | *项目层级:**0project 1folder 2template 3paragraph* |
响应示例:
{
"code": 200,
"message": "操作成功",
"data": [
{
"structureId": 65,
"structureName": "初步审查",
"parentId": 63,
"level": 1
},{
"structureId": 87,
"structureName": "初步审查第一部分",
"parentId": 73,
"level": 3
}
],
"timestamp": 1767691196099
}
3.10 查询材料
接口地址:
l 接口地址:/api/generateEdit/searchGenerationsMaterials
l 请求方式:GET
l Content-Type:application/json
l 响应类型:非流式响应
3.10.1 请求参数
| *字段名* | *类型* | *说明* | *字段名* |
|---|---|---|---|
| *caseId* | *Long* | *项目ID* |
请求示例:
curl --location --request GET 'https://bz-ai-server-dev.maas.com.cn/fjreportapi/api/generateEdit/searchGenerationsMaterials?caseId=1' \
--header 'User-Agent: Apifox/1.0.0 (https://apifox.com)' \
--header 'Accept: /' \
--header 'Host: bz-ai-server-dev.maas.com.cn' \
--header 'Connection: keep-alive'
3.10.2 响应参数
| *字段名* | *类型* | *说明* |
|---|---|---|
| *code* | *integer* | *状态码,例如 200 代表成功。* |
| *message* | *string* | *操作结果的描述信息,例如 "操作成功"。* |
| *data* | *object* | *核心业务数据对象* |
| *timestamp* | *long* | *服务器响应时的时间戳。* |
*data(数据列表)结构*
这是 data 数组中每个元素(项目)的详细字段。
| *参数名称* | *类型* | *说明* |
|---|---|---|
| *materialsname* | *String* | *材料名称(如:侦察卷、检察内卷)* |
| *files* | *Array* | *该分类下的文件/目录列表节点* |
*file(文件节点)结构*
| *字段名* | *类型* | *说明* |
|---|---|---|
| *caseFileId* | *Long* | *节点唯一ID* |
| *parentCaseField* | *Long* | *父节点ID,若为null则表示该分类下的根节点* |
| *fileName* | *String* | *文件或文件夹的显示名称* |
| *field* | *long* | *文件附件ID**若为null,表示这是一个文件夹/目录* |
响应示例:
{
"code": 200,
"message": "操作成功",
"data": [
{
"materialsname": "侦查卷",
"files": [
{
"fileId": null,
"parentCaseFileId": 360,
"fileName": "侦查卷",
"caseFileId": 361
},
{
"fileId": 219,
"parentCaseFileId": 361,
"fileName": "不予立案通知书",
"caseFileId": 362
}
]
}
],
"timestamp": 1767692224736
}
3.11 查询模板内容
接口地址:
l 接口地址:/api/templateEdit/getTemplateContent
l 请求方式:GET
l Content-Type:application/json
l 响应类型:非流式响应
3.11.1 请求参数
| *字段名* | *类型* | *说明* | *字段名* |
|---|---|---|---|
| *structureId* | *Long* | *是* | *结构**ID* |
请求示例:
curl --location --request GET 'https://bz-ai-server-dev.maas.com.cn/fjreportapi/api/templateEdit/getTemplateContent?structureId=1' \
--header 'User-Agent: Apifox/1.0.0 (https://apifox.com)' \
--header 'Accept: /' \
--header 'Host: bz-ai-server-dev.maas.com.cn' \
--header 'Connection: keep-alive'
3.11.2 响应参数
| *字段名* | *类型* | *说明* |
|---|---|---|
| *code* | *integer* | *状态码,例如 200 代表成功。* |
| *message* | *string* | *操作结果的描述信息,例如 "操作成功"。* |
| *data* | *object* | *返回模板内容结果* |
| *timestamp* | *long* | *服务器响应时的时间戳。* |
响应示例:
{
"code": 200,
"message": "操作成功",
"data": "
{{初步审查第一部分}}
{{初步审查第二部分}}
{{初步审查第三部分}}
","timestamp": 1767693151207
}
3.12 更新模板内容
接口地址:
l 接口地址:/api/templateEdit/updateTemplateContent
l 请求方式:POST
l Content-Type:application/json
l 响应类型:非流式响应
3.12.1 请求参数
| *字段名* | *类型* | *说明* | *字段名* |
|---|---|---|---|
| templateName | *String* | *示例:test1* | *模板名称* |
| templateContent | *String* | *更新后的模板内容* | *模板内容* |
请求示例:
curl --location --request POST 'https://bz-ai-server-dev.maas.com.cn/fjreportapi/api/templateEdit/updateTemplateContent' \
--header 'User-Agent: Apifox/1.0.0 (https://apifox.com)' \
--header 'Content-Type: application/json' \
--header 'Accept: /' \
--header 'Host: bz-ai-server-dev.maas.com.cn' \
--header 'Connection: keep-alive' \
--data-raw '{
"templateName": "test1",
"templateContent": "
{{初步审查第一部分}}
{{初步审查第二部分}}
{{初步审查第三部分}}
"}'
3.12.2 响应参数
| *字段名* | *类型* | *说明* |
|---|---|---|
| *code* | *integer* | *状态码,例如 200 代表成功。* |
| *message* | *string* | *操作结果的描述信息,例如 "操作成功"。* |
| *data* | *object* | *null* |
| *timestamp* | *long* | *服务器响应时的时间戳。* |
响应示例:
{
"code": 200,
"message": "操作成功",
"data": null,
"timestamp": 1767693526650
}