day11

#实习

今日新增接口:

  1. 查询变量
  2. 查询材料
  3. 查询模板内容
  4. 更新模板内容

调整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

}

← 返回首页