You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
34 KiB
34 KiB
积分申诉管理
本模块共 21 个接口。源文件：api.json。
快速索引
| 接口名称 | 方法 | 路径 | 用途 |
|---|---|---|---|
| 受理申诉 | POST | /gd_dataserver/gd_dataserver/business/points/appeal/accept/{id} |
将申诉状态从待受理(0)改为处理中(1)。返回 data 为 boolean。 |
| 新增 | POST | /gd_dataserver/gd_dataserver/business/points/appeal/add |
新增单条记录，请求体为实体类对象（字段说明见对应实体模型）。成功返回 data 为 null。 |
| 批量新增 | POST | /gd_dataserver/gd_dataserver/business/points/appeal/addBatch |
批量新增多条记录，请求体为实体类数组。成功返回 data 为 null。 |
| 新增并返回保存的数据 | POST | /gd_dataserver/gd_dataserver/business/points/appeal/addReturn |
新增单条记录并返回保存后的数据（含自增ID），请求体为实体类对象。成功返回 data 为保存的实体对象。 |
| 审批申诉流程 | POST | /gd_dataserver/gd_dataserver/business/points/appeal/completeFlow |
审批通过或驳回申诉流程节点。成功返回 data 为 null；失败返回 error 信息。 |
| 根据属性删除 | GET | /gd_dataserver/gd_dataserver/business/points/appeal/delete |
根据实体属性条件删除记录，请求体为实体类对象。成功返回 data 为 null。 |
| 主键删除 | GET | /gd_dataserver/gd_dataserver/business/points/appeal/deleteById |
根据主键ID删除单条记录，成功返回 data 为 null。 |
| 批量删除 | GET | /gd_dataserver/gd_dataserver/business/points/appeal/deleteByIds |
根据ID列表批量删除记录，成功返回 data 为 null。 |
| 获取申诉详情 | GET | /gd_dataserver/gd_dataserver/business/points/appeal/detail/{id} |
返回 data 为 PointsAppeal 对象，包含完整申诉字段及流程进度信息。 |
| 查询所有 | GET | /gd_dataserver/gd_dataserver/business/points/appeal/getAll |
查询所有记录（无分页、无条件）。成功返回 data 为实体类数组。 |
| 分页查询 | GET | /gd_dataserver/gd_dataserver/business/points/appeal/getListByPage |
分页查询记录列表，查询条件为实体类字段。成功返回 data 为 PageInfo 分页对象，其中 list 为实体类数组。 |
| 处理申诉 | POST | /gd_dataserver/gd_dataserver/business/points/appeal/handle/{id} |
通过或驳回申诉，可选调整积分。approved=true时状态改为已通过(2)，approved=false时改为已驳回(3)。adjustPoints为正数补发积分，负数扣减积分，不传则不调整。返回 data 为 boolean。 |
| 详情 | GET | /gd_dataserver/gd_dataserver/business/points/appeal/info |
根据主键ID查询单条记录详情。成功返回 data 为实体类对象，包含该实体所有字段。 |
| 条件查询 | GET | /gd_dataserver/gd_dataserver/business/points/appeal/list |
根据实体属性条件查询记录列表。成功返回 data 为实体类数组。 |
| 查询我的申诉记录（APP端） | GET | /gd_dataserver/gd_dataserver/business/points/appeal/myList |
返回 data 为 PageInfo 分页对象。list 中每条记录为 PointsAppeal 对象，主要字段：id、appealNo-申诉编号、appealType-申诉类型(REJECT/POINTS/OTHER)、status-状态(0待受理/1处理中/2已通过/3已驳回/4已撤回)、statusName-状态名称、handleRemark-处理意见、adjustPoints-调整积分、createTime。 |
| 逻辑删除 | GET | /gd_dataserver/gd_dataserver/business/points/appeal/removeById |
根据主键ID逻辑删除单条记录，成功返回 data 为 null。 |
| 提交申诉（APP端） | POST | /gd_dataserver/gd_dataserver/business/points/appeal/submit |
填写申诉类型、理由等信息，申诉人信息从登录用户获取。返回 data 为 PointsAppeal 对象，包含 id、appealNo-申诉编号、status-状态(0待受理)。 |
| 提交申诉并启动流程（APP端） | POST | /gd_dataserver/gd_dataserver/business/points/appeal/submitFlow |
提交申诉并自动启动 Flowable 审批流程。成功返回 data 为流程实例ID字符串；失败返回 error 信息。 |
| 申诉流程待办列表 | GET | /gd_dataserver/gd_dataserver/business/points/appeal/todoList |
返回 data 为 PageInfo 分页对象。list 中每条记录为 PointsAppeal 对象，包含 id、appealNo、userName、appealType-申诉类型、appealReason-申诉理由、status-状态、createTime。 |
| 修改 | POST | /gd_dataserver/gd_dataserver/business/points/appeal/updateById |
根据主键ID修改记录，请求体为实体类对象（需包含id字段）。成功返回 data 为 null。 |
| 撤回申诉（APP端） | POST | /gd_dataserver/gd_dataserver/business/points/appeal/withdraw/{id} |
仅待受理状态(status=0)可撤回，撤回后状态改为已撤回(4)。返回 data 为 boolean。 |
接口详情
受理申诉
- 用途： 将申诉状态从待受理(0)改为处理中(1)。返回 data 为 boolean。
- 请求：
POST /gd_dataserver/gd_dataserver/business/points/appeal/accept/{id} - 鉴权：
X-Access-Token（以接口定义为准） - operationId：
acceptAppealUsingPOST
参数：
| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|---|
| id | path | 是 | integer / int64 | 申诉ID | - |
响应：
| 状态码 | 说明 | 响应模型 |
|---|---|---|
| 200 | OK | /: object<string, object> |
| 201 | Created | - |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
新增
- 用途： 新增单条记录，请求体为实体类对象（字段说明见对应实体模型）。成功返回 data 为 null。
- 请求：
POST /gd_dataserver/gd_dataserver/business/points/appeal/add - 鉴权：
X-Access-Token（以接口定义为准） - operationId：
addOneUsingPOST_9
参数：
无
请求体：
- Content-Type：
application/json - 模型：
积分申诉 - 必填：文档未标记
| 字段 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
| adjustPoints | 否 | integer / int32 | 调整积分（正数补发，负数扣减） | - |
| appealNo | 否 | string | 申诉编号 | - |
| appealReason | 否 | string | 申诉理由 | - |
| appealType | 否 | string | 申诉类型：REJECT-审核驳回申诉 POINTS-积分异议 OTHER-其他 | - |
| attachmentUrls | 否 | string | 附件URL（JSON数组） | - |
| canApprove | 否 | boolean | 当前用户是否可审批此流程 | false |
| createTime | 否 | string / date-time | 创建时间 | - |
| flowInstanceId | 否 | string | 流程实例ID（预留） | - |
| flowStatus | 否 | integer / int32 | 流程状态：0-无流程 1-进行中 2-已完成 | - |
| handleRemark | 否 | string | 处理意见/结果说明 | - |
| handleTime | 否 | string / date-time | 处理时间 | - |
| handleUserId | 否 | integer / int64 | 处理人用户ID | - |
| handleUserName | 否 | string | 处理人姓名 | - |
| id | 否 | integer / int64 | 主键ID | - |
| isInitiator | 否 | boolean | 当前用户是否为此流程发起人 | false |
| reportId | 否 | integer / int64 | 关联隐患上报ID | - |
| reportNo | 否 | string | 关联隐患编号 | - |
| status | 否 | string | 申诉状态：0-待受理 1-处理中 2-已通过 3-已驳回 4-已撤回 | - |
| statusName | 否 | string | 申诉状态名称 | - |
| updateTime | 否 | string / date-time | 更新时间 | - |
| userId | 否 | integer / int64 | 申诉人用户ID | - |
| userName | 否 | string | 申诉人姓名 | - |
响应：
| 状态码 | 说明 | 响应模型 |
|---|---|---|
| 200 | OK | /: object<string, object> |
| 201 | Created | - |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
批量新增
- 用途： 批量新增多条记录，请求体为实体类数组。成功返回 data 为 null。
- 请求：
POST /gd_dataserver/gd_dataserver/business/points/appeal/addBatch - 鉴权：
X-Access-Token（以接口定义为准） - operationId：
addBatchUsingPOST_9
参数：
无
请求体：
- Content-Type：
application/json - 模型：
array<积分申诉> - 必填：文档未标记
响应：
| 状态码 | 说明 | 响应模型 |
|---|---|---|
| 200 | OK | /: object<string, object> |
| 201 | Created | - |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
新增并返回保存的数据
- 用途： 新增单条记录并返回保存后的数据（含自增ID），请求体为实体类对象。成功返回 data 为保存的实体对象。
- 请求：
POST /gd_dataserver/gd_dataserver/business/points/appeal/addReturn - 鉴权：
X-Access-Token（以接口定义为准） - operationId：
addReturnUsingPOST_9
参数：
无
请求体：
- Content-Type：
application/json - 模型：
积分申诉 - 必填：文档未标记
| 字段 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
| adjustPoints | 否 | integer / int32 | 调整积分（正数补发，负数扣减） | - |
| appealNo | 否 | string | 申诉编号 | - |
| appealReason | 否 | string | 申诉理由 | - |
| appealType | 否 | string | 申诉类型：REJECT-审核驳回申诉 POINTS-积分异议 OTHER-其他 | - |
| attachmentUrls | 否 | string | 附件URL（JSON数组） | - |
| canApprove | 否 | boolean | 当前用户是否可审批此流程 | false |
| createTime | 否 | string / date-time | 创建时间 | - |
| flowInstanceId | 否 | string | 流程实例ID（预留） | - |
| flowStatus | 否 | integer / int32 | 流程状态：0-无流程 1-进行中 2-已完成 | - |
| handleRemark | 否 | string | 处理意见/结果说明 | - |
| handleTime | 否 | string / date-time | 处理时间 | - |
| handleUserId | 否 | integer / int64 | 处理人用户ID | - |
| handleUserName | 否 | string | 处理人姓名 | - |
| id | 否 | integer / int64 | 主键ID | - |
| isInitiator | 否 | boolean | 当前用户是否为此流程发起人 | false |
| reportId | 否 | integer / int64 | 关联隐患上报ID | - |
| reportNo | 否 | string | 关联隐患编号 | - |
| status | 否 | string | 申诉状态：0-待受理 1-处理中 2-已通过 3-已驳回 4-已撤回 | - |
| statusName | 否 | string | 申诉状态名称 | - |
| updateTime | 否 | string / date-time | 更新时间 | - |
| userId | 否 | integer / int64 | 申诉人用户ID | - |
| userName | 否 | string | 申诉人姓名 | - |
响应：
| 状态码 | 说明 | 响应模型 |
|---|---|---|
| 200 | OK | /: object<string, object> |
| 201 | Created | - |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
审批申诉流程
- 用途： 审批通过或驳回申诉流程节点。成功返回 data 为 null；失败返回 error 信息。
- 请求：
POST /gd_dataserver/gd_dataserver/business/points/appeal/completeFlow - 鉴权：
X-Access-Token（以接口定义为准） - operationId：
completeFlowUsingPOST
参数：
无
请求体：
- Content-Type：
application/json - 模型：
工作流签字任务相关--请求参数 - 必填：文档未标记
| 字段 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
| assignee | 否 | string | 审批人 | - |
| candidateGroups | 否 | array | 审批组 | - |
| candidateUsers | 否 | array | 候选人 | - |
| comment | 否 | string | 任务意见 | - |
| currentChildExecutionId | 否 | string | 子执行流ID | - |
| defId | 否 | string | 流程环节定义ID | - |
| deploymentId | 否 | string | 部署ID | - |
| file | 否 | string | 拍照 | - |
| flag | 否 | boolean | 子执行流是否已执行 | false |
| instanceId | 否 | string | 流程实例Id | - |
| qz | 否 | string | 任务签字 | - |
| result | 否 | string | 任务审批结果 1-同意 2-退回 | - |
| targetKey | 否 | string | 节点 | - |
| taskId | 否 | string | 任务Id | - |
| taskName | 否 | string | 任务名称 | - |
| type | 否 | string | 业务类型 | - |
| userId | 否 | string | 用户Id | - |
| userName | 否 | string | 用户名称 | - |
| variables | 否 | object | 流程变量信息 | - |
| zyxkid | 否 | string | 作业许可Id | - |
响应：
| 状态码 | 说明 | 响应模型 |
|---|---|---|
| 200 | OK | /: object<string, object> |
| 201 | Created | - |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
根据属性删除
- 用途： 根据实体属性条件删除记录，请求体为实体类对象。成功返回 data 为 null。
- 请求：
GET /gd_dataserver/gd_dataserver/business/points/appeal/delete - 鉴权：
X-Access-Token（以接口定义为准） - operationId：
deleteUsingGET_9
参数：
| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|---|
| adjustPoints | query | 否 | integer / int32 | 调整积分（正数补发，负数扣减） | - |
| appealNo | query | 否 | string | 申诉编号 | - |
| appealReason | query | 否 | string | 申诉理由 | - |
| appealType | query | 否 | string | 申诉类型：REJECT-审核驳回申诉 POINTS-积分异议 OTHER-其他 | - |
| attachmentUrls | query | 否 | string | 附件URL（JSON数组） | - |
| canApprove | query | 否 | boolean | 当前用户是否可审批此流程 | - |
| createTime | query | 否 | string / date-time | 创建时间 | - |
| flowInstanceId | query | 否 | string | 流程实例ID（预留） | - |
| flowStatus | query | 否 | integer / int32 | 流程状态：0-无流程 1-进行中 2-已完成 | - |
| handleRemark | query | 否 | string | 处理意见/结果说明 | - |
| handleTime | query | 否 | string / date-time | 处理时间 | - |
| handleUserId | query | 否 | integer / int64 | 处理人用户ID | - |
| handleUserName | query | 否 | string | 处理人姓名 | - |
| id | query | 否 | integer / int64 | 主键ID | - |
| isInitiator | query | 否 | boolean | 当前用户是否为此流程发起人 | - |
| reportId | query | 否 | integer / int64 | 关联隐患上报ID | - |
| reportNo | query | 否 | string | 关联隐患编号 | - |
| status | query | 否 | string | 申诉状态：0-待受理 1-处理中 2-已通过 3-已驳回 4-已撤回 | - |
| statusName | query | 否 | string | 申诉状态名称 | - |
| updateTime | query | 否 | string / date-time | 更新时间 | - |
| userId | query | 否 | integer / int64 | 申诉人用户ID | - |
| userName | query | 否 | string | 申诉人姓名 | - |
响应：
| 状态码 | 说明 | 响应模型 |
|---|---|---|
| 200 | OK | /: object<string, object> |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
主键删除
- 用途： 根据主键ID删除单条记录，成功返回 data 为 null。
- 请求：
GET /gd_dataserver/gd_dataserver/business/points/appeal/deleteById - 鉴权：
X-Access-Token（以接口定义为准） - operationId：
deleteOneUsingGET_9
参数：
| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|---|
| id | query | 是 | string | 主键ID | - |
响应：
| 状态码 | 说明 | 响应模型 |
|---|---|---|
| 200 | OK | /: object<string, object> |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
批量删除
- 用途： 根据ID列表批量删除记录，成功返回 data 为 null。
- 请求：
GET /gd_dataserver/gd_dataserver/business/points/appeal/deleteByIds - 鉴权：
X-Access-Token（以接口定义为准） - operationId：
deleteListUsingGET_19
参数：
| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|---|
| ids | query | 是 | string | ID列表(逗号分隔) | - |
响应：
| 状态码 | 说明 | 响应模型 |
|---|---|---|
| 200 | OK | /: object<string, object> |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
获取申诉详情
- 用途： 返回 data 为 PointsAppeal 对象，包含完整申诉字段及流程进度信息。
- 请求：
GET /gd_dataserver/gd_dataserver/business/points/appeal/detail/{id} - 鉴权：
X-Access-Token（以接口定义为准） - operationId：
getDetailUsingGET
参数：
| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|---|
| id | path | 是 | integer / int64 | 申诉ID | - |
响应：
| 状态码 | 说明 | 响应模型 |
|---|---|---|
| 200 | OK | /: object<string, object> |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
查询所有
- 用途： 查询所有记录（无分页、无条件）。成功返回 data 为实体类数组。
- 请求：
GET /gd_dataserver/gd_dataserver/business/points/appeal/getAll - 鉴权：
X-Access-Token（以接口定义为准） - operationId：
getAllUsingGET_9
参数：
无
响应：
| 状态码 | 说明 | 响应模型 |
|---|---|---|
| 200 | OK | /: object<string, object> |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
分页查询
- 用途： 分页查询记录列表，查询条件为实体类字段。成功返回 data 为 PageInfo 分页对象，其中 list 为实体类数组。
- 请求：
GET /gd_dataserver/gd_dataserver/business/points/appeal/getListByPage - 鉴权：
X-Access-Token（以接口定义为准） - operationId：
getListByPageUsingGET_9
参数：
| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|---|
| adjustPoints | query | 否 | integer / int32 | 调整积分（正数补发，负数扣减） | - |
| appealNo | query | 否 | string | 申诉编号 | - |
| appealReason | query | 否 | string | 申诉理由 | - |
| appealType | query | 否 | string | 申诉类型：REJECT-审核驳回申诉 POINTS-积分异议 OTHER-其他 | - |
| attachmentUrls | query | 否 | string | 附件URL（JSON数组） | - |
| canApprove | query | 否 | boolean | 当前用户是否可审批此流程 | - |
| createTime | query | 否 | string / date-time | 创建时间 | - |
| flowInstanceId | query | 否 | string | 流程实例ID（预留） | - |
| flowStatus | query | 否 | integer / int32 | 流程状态：0-无流程 1-进行中 2-已完成 | - |
| handleRemark | query | 否 | string | 处理意见/结果说明 | - |
| handleTime | query | 否 | string / date-time | 处理时间 | - |
| handleUserId | query | 否 | integer / int64 | 处理人用户ID | - |
| handleUserName | query | 否 | string | 处理人姓名 | - |
| id | query | 否 | integer / int64 | 主键ID | - |
| isInitiator | query | 否 | boolean | 当前用户是否为此流程发起人 | - |
| pageNum | query | 是 | integer / int32 | 页码 | - |
| reportId | query | 否 | integer / int64 | 关联隐患上报ID | - |
| reportNo | query | 否 | string | 关联隐患编号 | - |
| status | query | 否 | string | 申诉状态：0-待受理 1-处理中 2-已通过 3-已驳回 4-已撤回 | - |
| statusName | query | 否 | string | 申诉状态名称 | - |
| updateTime | query | 否 | string / date-time | 更新时间 | - |
| userId | query | 否 | integer / int64 | 申诉人用户ID | - |
| userName | query | 否 | string | 申诉人姓名 | - |
| pageSize | query | 是 | integer / int32 | 每页条数 | - |
响应：
| 状态码 | 说明 | 响应模型 |
|---|---|---|
| 200 | OK | /: object<string, object> |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
处理申诉
- 用途： 通过或驳回申诉，可选调整积分。approved=true时状态改为已通过(2)，approved=false时改为已驳回(3)。adjustPoints为正数补发积分，负数扣减积分，不传则不调整。返回 data 为 boolean。
- 请求：
POST /gd_dataserver/gd_dataserver/business/points/appeal/handle/{id} - 鉴权：
X-Access-Token（以接口定义为准） - operationId：
handleAppealUsingPOST
参数：
| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|---|
| id | path | 是 | integer / int64 | 申诉ID | - |
| approved | query | 是 | boolean | 是否通过 | - |
| handleRemark | query | 是 | string | 处理意见 | - |
| adjustPoints | query | 否 | integer / int32 | 调整积分（正数补发，负数扣减，不传则不调整） | - |
响应：
| 状态码 | 说明 | 响应模型 |
|---|---|---|
| 200 | OK | /: object<string, object> |
| 201 | Created | - |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
详情
- 用途： 根据主键ID查询单条记录详情。成功返回 data 为实体类对象，包含该实体所有字段。
- 请求：
GET /gd_dataserver/gd_dataserver/business/points/appeal/info - 鉴权：
X-Access-Token（以接口定义为准） - operationId：
infoUsingGET_9
参数：
| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|---|
| id | query | 是 | string | 主键ID | - |
响应：
| 状态码 | 说明 | 响应模型 |
|---|---|---|
| 200 | OK | /: object<string, object> |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
条件查询
- 用途： 根据实体属性条件查询记录列表。成功返回 data 为实体类数组。
- 请求：
GET /gd_dataserver/gd_dataserver/business/points/appeal/list - 鉴权：
X-Access-Token（以接口定义为准） - operationId：
getListUsingGET_9
参数：
| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|---|
| adjustPoints | query | 否 | integer / int32 | 调整积分（正数补发，负数扣减） | - |
| appealNo | query | 否 | string | 申诉编号 | - |
| appealReason | query | 否 | string | 申诉理由 | - |
| appealType | query | 否 | string | 申诉类型：REJECT-审核驳回申诉 POINTS-积分异议 OTHER-其他 | - |
| attachmentUrls | query | 否 | string | 附件URL（JSON数组） | - |
| canApprove | query | 否 | boolean | 当前用户是否可审批此流程 | - |
| createTime | query | 否 | string / date-time | 创建时间 | - |
| flowInstanceId | query | 否 | string | 流程实例ID（预留） | - |
| flowStatus | query | 否 | integer / int32 | 流程状态：0-无流程 1-进行中 2-已完成 | - |
| handleRemark | query | 否 | string | 处理意见/结果说明 | - |
| handleTime | query | 否 | string / date-time | 处理时间 | - |
| handleUserId | query | 否 | integer / int64 | 处理人用户ID | - |
| handleUserName | query | 否 | string | 处理人姓名 | - |
| id | query | 否 | integer / int64 | 主键ID | - |
| isInitiator | query | 否 | boolean | 当前用户是否为此流程发起人 | - |
| reportId | query | 否 | integer / int64 | 关联隐患上报ID | - |
| reportNo | query | 否 | string | 关联隐患编号 | - |
| status | query | 否 | string | 申诉状态：0-待受理 1-处理中 2-已通过 3-已驳回 4-已撤回 | - |
| statusName | query | 否 | string | 申诉状态名称 | - |
| updateTime | query | 否 | string / date-time | 更新时间 | - |
| userId | query | 否 | integer / int64 | 申诉人用户ID | - |
| userName | query | 否 | string | 申诉人姓名 | - |
响应：
| 状态码 | 说明 | 响应模型 |
|---|---|---|
| 200 | OK | /: object<string, object> |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
查询我的申诉记录（APP端）
- 用途： 返回 data 为 PageInfo 分页对象。list 中每条记录为 PointsAppeal 对象，主要字段：id、appealNo-申诉编号、appealType-申诉类型(REJECT/POINTS/OTHER)、status-状态(0待受理/1处理中/2已通过/3已驳回/4已撤回)、statusName-状态名称、handleRemark-处理意见、adjustPoints-调整积分、createTime。
- 请求：
GET /gd_dataserver/gd_dataserver/business/points/appeal/myList - 鉴权：
X-Access-Token（以接口定义为准） - operationId：
myListUsingGET_2
参数：
| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|---|
| adjustPoints | query | 否 | integer / int32 | 调整积分（正数补发，负数扣减） | - |
| appealNo | query | 否 | string | 申诉编号 | - |
| appealReason | query | 否 | string | 申诉理由 | - |
| appealType | query | 否 | string | 申诉类型：REJECT-审核驳回申诉 POINTS-积分异议 OTHER-其他 | - |
| attachmentUrls | query | 否 | string | 附件URL（JSON数组） | - |
| canApprove | query | 否 | boolean | 当前用户是否可审批此流程 | - |
| createTime | query | 否 | string / date-time | 创建时间 | - |
| flowInstanceId | query | 否 | string | 流程实例ID（预留） | - |
| flowStatus | query | 否 | integer / int32 | 流程状态：0-无流程 1-进行中 2-已完成 | - |
| handleRemark | query | 否 | string | 处理意见/结果说明 | - |
| handleTime | query | 否 | string / date-time | 处理时间 | - |
| handleUserId | query | 否 | integer / int64 | 处理人用户ID | - |
| handleUserName | query | 否 | string | 处理人姓名 | - |
| id | query | 否 | integer / int64 | 主键ID | - |
| isInitiator | query | 否 | boolean | 当前用户是否为此流程发起人 | - |
| pageNum | query | 否 | integer / int32 | 页码 | - |
| reportId | query | 否 | integer / int64 | 关联隐患上报ID | - |
| reportNo | query | 否 | string | 关联隐患编号 | - |
| status | query | 否 | string | 申诉状态：0-待受理 1-处理中 2-已通过 3-已驳回 4-已撤回 | - |
| statusName | query | 否 | string | 申诉状态名称 | - |
| updateTime | query | 否 | string / date-time | 更新时间 | - |
| userId | query | 否 | integer / int64 | 申诉人用户ID | - |
| userName | query | 否 | string | 申诉人姓名 | - |
| pageSize | query | 否 | integer / int32 | 每页数量 | - |
响应：
| 状态码 | 说明 | 响应模型 |
|---|---|---|
| 200 | OK | /: object<string, object> |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
逻辑删除
- 用途： 根据主键ID逻辑删除单条记录，成功返回 data 为 null。
- 请求：
GET /gd_dataserver/gd_dataserver/business/points/appeal/removeById - 鉴权：
X-Access-Token（以接口定义为准） - operationId：
deleteListUsingGET_18
参数：
| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|---|
| id | query | 是 | string | 主键ID | - |
响应：
| 状态码 | 说明 | 响应模型 |
|---|---|---|
| 200 | OK | /: object<string, object> |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
提交申诉（APP端）
- 用途： 填写申诉类型、理由等信息，申诉人信息从登录用户获取。返回 data 为 PointsAppeal 对象，包含 id、appealNo-申诉编号、status-状态(0待受理)。
- 请求：
POST /gd_dataserver/gd_dataserver/business/points/appeal/submit - 鉴权：
X-Access-Token（以接口定义为准） - operationId：
submitAppealUsingPOST
参数：
无
请求体：
- Content-Type：
application/json - 模型：
积分申诉 - 必填：文档未标记
| 字段 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
| adjustPoints | 否 | integer / int32 | 调整积分（正数补发，负数扣减） | - |
| appealNo | 否 | string | 申诉编号 | - |
| appealReason | 否 | string | 申诉理由 | - |
| appealType | 否 | string | 申诉类型：REJECT-审核驳回申诉 POINTS-积分异议 OTHER-其他 | - |
| attachmentUrls | 否 | string | 附件URL（JSON数组） | - |
| canApprove | 否 | boolean | 当前用户是否可审批此流程 | false |
| createTime | 否 | string / date-time | 创建时间 | - |
| flowInstanceId | 否 | string | 流程实例ID（预留） | - |
| flowStatus | 否 | integer / int32 | 流程状态：0-无流程 1-进行中 2-已完成 | - |
| handleRemark | 否 | string | 处理意见/结果说明 | - |
| handleTime | 否 | string / date-time | 处理时间 | - |
| handleUserId | 否 | integer / int64 | 处理人用户ID | - |
| handleUserName | 否 | string | 处理人姓名 | - |
| id | 否 | integer / int64 | 主键ID | - |
| isInitiator | 否 | boolean | 当前用户是否为此流程发起人 | false |
| reportId | 否 | integer / int64 | 关联隐患上报ID | - |
| reportNo | 否 | string | 关联隐患编号 | - |
| status | 否 | string | 申诉状态：0-待受理 1-处理中 2-已通过 3-已驳回 4-已撤回 | - |
| statusName | 否 | string | 申诉状态名称 | - |
| updateTime | 否 | string / date-time | 更新时间 | - |
| userId | 否 | integer / int64 | 申诉人用户ID | - |
| userName | 否 | string | 申诉人姓名 | - |
响应：
| 状态码 | 说明 | 响应模型 |
|---|---|---|
| 200 | OK | /: object<string, object> |
| 201 | Created | - |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
提交申诉并启动流程（APP端）
- 用途： 提交申诉并自动启动 Flowable 审批流程。成功返回 data 为流程实例ID字符串；失败返回 error 信息。
- 请求：
POST /gd_dataserver/gd_dataserver/business/points/appeal/submitFlow - 鉴权：
X-Access-Token（以接口定义为准） - operationId：
submitAppealFlowUsingPOST
参数：
无
请求体：
- Content-Type：
application/json - 模型：
积分申诉 - 必填：文档未标记
| 字段 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
| adjustPoints | 否 | integer / int32 | 调整积分（正数补发，负数扣减） | - |
| appealNo | 否 | string | 申诉编号 | - |
| appealReason | 否 | string | 申诉理由 | - |
| appealType | 否 | string | 申诉类型：REJECT-审核驳回申诉 POINTS-积分异议 OTHER-其他 | - |
| attachmentUrls | 否 | string | 附件URL（JSON数组） | - |
| canApprove | 否 | boolean | 当前用户是否可审批此流程 | false |
| createTime | 否 | string / date-time | 创建时间 | - |
| flowInstanceId | 否 | string | 流程实例ID（预留） | - |
| flowStatus | 否 | integer / int32 | 流程状态：0-无流程 1-进行中 2-已完成 | - |
| handleRemark | 否 | string | 处理意见/结果说明 | - |
| handleTime | 否 | string / date-time | 处理时间 | - |
| handleUserId | 否 | integer / int64 | 处理人用户ID | - |
| handleUserName | 否 | string | 处理人姓名 | - |
| id | 否 | integer / int64 | 主键ID | - |
| isInitiator | 否 | boolean | 当前用户是否为此流程发起人 | false |
| reportId | 否 | integer / int64 | 关联隐患上报ID | - |
| reportNo | 否 | string | 关联隐患编号 | - |
| status | 否 | string | 申诉状态：0-待受理 1-处理中 2-已通过 3-已驳回 4-已撤回 | - |
| statusName | 否 | string | 申诉状态名称 | - |
| updateTime | 否 | string / date-time | 更新时间 | - |
| userId | 否 | integer / int64 | 申诉人用户ID | - |
| userName | 否 | string | 申诉人姓名 | - |
响应：
| 状态码 | 说明 | 响应模型 |
|---|---|---|
| 200 | OK | /: object<string, object> |
| 201 | Created | - |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
申诉流程待办列表
- 用途： 返回 data 为 PageInfo 分页对象。list 中每条记录为 PointsAppeal 对象，包含 id、appealNo、userName、appealType-申诉类型、appealReason-申诉理由、status-状态、createTime。
- 请求：
GET /gd_dataserver/gd_dataserver/business/points/appeal/todoList - 鉴权：
X-Access-Token（以接口定义为准） - operationId：
todoListUsingGET_2
参数：
| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|---|
| params | query | 是 | object<string, string> | 查询参数（支持pageNum/pageSize等） | - |
响应：
| 状态码 | 说明 | 响应模型 |
|---|---|---|
| 200 | OK | /: object<string, object> |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
修改
- 用途： 根据主键ID修改记录，请求体为实体类对象（需包含id字段）。成功返回 data 为 null。
- 请求：
POST /gd_dataserver/gd_dataserver/business/points/appeal/updateById - 鉴权：
X-Access-Token（以接口定义为准） - operationId：
updateByIdUsingPOST_9
参数：
无
请求体：
- Content-Type：
application/json - 模型：
积分申诉 - 必填：文档未标记
| 字段 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
| adjustPoints | 否 | integer / int32 | 调整积分（正数补发，负数扣减） | - |
| appealNo | 否 | string | 申诉编号 | - |
| appealReason | 否 | string | 申诉理由 | - |
| appealType | 否 | string | 申诉类型：REJECT-审核驳回申诉 POINTS-积分异议 OTHER-其他 | - |
| attachmentUrls | 否 | string | 附件URL（JSON数组） | - |
| canApprove | 否 | boolean | 当前用户是否可审批此流程 | false |
| createTime | 否 | string / date-time | 创建时间 | - |
| flowInstanceId | 否 | string | 流程实例ID（预留） | - |
| flowStatus | 否 | integer / int32 | 流程状态：0-无流程 1-进行中 2-已完成 | - |
| handleRemark | 否 | string | 处理意见/结果说明 | - |
| handleTime | 否 | string / date-time | 处理时间 | - |
| handleUserId | 否 | integer / int64 | 处理人用户ID | - |
| handleUserName | 否 | string | 处理人姓名 | - |
| id | 否 | integer / int64 | 主键ID | - |
| isInitiator | 否 | boolean | 当前用户是否为此流程发起人 | false |
| reportId | 否 | integer / int64 | 关联隐患上报ID | - |
| reportNo | 否 | string | 关联隐患编号 | - |
| status | 否 | string | 申诉状态：0-待受理 1-处理中 2-已通过 3-已驳回 4-已撤回 | - |
| statusName | 否 | string | 申诉状态名称 | - |
| updateTime | 否 | string / date-time | 更新时间 | - |
| userId | 否 | integer / int64 | 申诉人用户ID | - |
| userName | 否 | string | 申诉人姓名 | - |
响应：
| 状态码 | 说明 | 响应模型 |
|---|---|---|
| 200 | OK | /: object<string, object> |
| 201 | Created | - |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
撤回申诉（APP端）
- 用途： 仅待受理状态(status=0)可撤回，撤回后状态改为已撤回(4)。返回 data 为 boolean。
- 请求：
POST /gd_dataserver/gd_dataserver/business/points/appeal/withdraw/{id} - 鉴权：
X-Access-Token（以接口定义为准） - operationId：
withdrawAppealUsingPOST
参数：
| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|---|
| id | path | 是 | integer / int64 | 申诉ID | - |
响应：
| 状态码 | 说明 | 响应模型 |
|---|---|---|
| 200 | OK | /: object<string, object> |
| 201 | Created | - |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |