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.
20562 lines
492 KiB
20562 lines
492 KiB
[ |
|
{ |
|
"tag": "用户积分账户", |
|
"name": "新增", |
|
"usage": "新增单条记录,请求体为实体类对象(字段说明见对应实体模型)。成功返回 data 为 null。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/balance/add", |
|
"operationId": "addOneUsingPOST", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "用户积分账户" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "用户积分账户", |
|
"name": "批量新增", |
|
"usage": "批量新增多条记录,请求体为实体类数组。成功返回 data 为 null。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/balance/addBatch", |
|
"operationId": "addBatchUsingPOST", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "array<用户积分账户>" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "用户积分账户", |
|
"name": "新增并返回保存的数据", |
|
"usage": "新增单条记录并返回保存后的数据(含自增ID),请求体为实体类对象。成功返回 data 为保存的实体对象。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/balance/addReturn", |
|
"operationId": "addReturnUsingPOST", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "用户积分账户" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "用户积分账户", |
|
"name": "手动调整积分(PC管理端)", |
|
"usage": "管理员手动补发或扣减指定用户的积分。points为正数补发,为负数扣减。操作会同时生成积分流水(bizType=MANUAL_ADD/MANUAL_DEDUCT)和审计日志。返回 data 为 boolean,true-调整成功。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/balance/adjust", |
|
"operationId": "adjustPointsUsingPOST", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/x-www-form-urlencoded", |
|
"schema": "integer / int32" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "用户积分账户", |
|
"name": "根据属性删除", |
|
"usage": "根据实体属性条件删除记录,请求体为实体类对象。成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/balance/delete", |
|
"operationId": "deleteUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "availableBalance", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "可用积分余额" |
|
}, |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "frozenBalance", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "冻结积分余额" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "totalIncome", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "历史总入账积分" |
|
}, |
|
{ |
|
"name": "totalOutcome", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "历史总出账积分" |
|
}, |
|
{ |
|
"name": "updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "更新时间" |
|
}, |
|
{ |
|
"name": "userId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "用户ID" |
|
}, |
|
{ |
|
"name": "version", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "乐观锁版本号" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "用户积分账户", |
|
"name": "主键删除", |
|
"usage": "根据主键ID删除单条记录,成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/balance/deleteById", |
|
"operationId": "deleteOneUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "主键ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "用户积分账户", |
|
"name": "批量删除", |
|
"usage": "根据ID列表批量删除记录,成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/balance/deleteByIds", |
|
"operationId": "deleteListUsingGET_1", |
|
"parameters": [ |
|
{ |
|
"name": "ids", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "ID列表(逗号分隔)" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "用户积分账户", |
|
"name": "查询所有", |
|
"usage": "查询所有记录(无分页、无条件)。成功返回 data 为实体类数组。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/balance/getAll", |
|
"operationId": "getAllUsingGET", |
|
"parameters": [], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "用户积分账户", |
|
"name": "查询用户积分账户", |
|
"usage": "返回 data 为 AccountBalance 对象。字段:userId-用户ID、availableBalance-可用积分余额、frozenBalance-冻结积分、totalIncome-历史总入账、totalOutcome-历史总出账。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/balance/getByUserId/{userId}", |
|
"operationId": "getByUserIdUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "userId", |
|
"in": "path", |
|
"required": true, |
|
"type": "integer / int64", |
|
"description": "用户ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "用户积分账户", |
|
"name": "分页查询", |
|
"usage": "分页查询记录列表,查询条件为实体类字段。成功返回 data 为 PageInfo 分页对象,其中 list 为实体类数组。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/balance/getListByPage", |
|
"operationId": "getListByPageUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "availableBalance", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "可用积分余额" |
|
}, |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "frozenBalance", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "冻结积分余额" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "pageNum", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "页码" |
|
}, |
|
{ |
|
"name": "totalIncome", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "历史总入账积分" |
|
}, |
|
{ |
|
"name": "totalOutcome", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "历史总出账积分" |
|
}, |
|
{ |
|
"name": "updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "更新时间" |
|
}, |
|
{ |
|
"name": "userId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "用户ID" |
|
}, |
|
{ |
|
"name": "version", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "乐观锁版本号" |
|
}, |
|
{ |
|
"name": "pageSize", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "每页条数" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "用户积分账户", |
|
"name": "详情", |
|
"usage": "根据主键ID查询单条记录详情。成功返回 data 为实体类对象,包含该实体所有字段。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/balance/info", |
|
"operationId": "infoUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "主键ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "用户积分账户", |
|
"name": "条件查询", |
|
"usage": "根据实体属性条件查询记录列表。成功返回 data 为实体类数组。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/balance/list", |
|
"operationId": "getListUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "availableBalance", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "可用积分余额" |
|
}, |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "frozenBalance", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "冻结积分余额" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "totalIncome", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "历史总入账积分" |
|
}, |
|
{ |
|
"name": "totalOutcome", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "历史总出账积分" |
|
}, |
|
{ |
|
"name": "updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "更新时间" |
|
}, |
|
{ |
|
"name": "userId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "用户ID" |
|
}, |
|
{ |
|
"name": "version", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "乐观锁版本号" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "用户积分账户", |
|
"name": "查询当前用户积分账户(APP端)", |
|
"usage": "返回 data 为 AccountBalance 对象。字段:userId-用户ID、availableBalance-可用积分余额、frozenBalance-冻结积分、totalIncome-历史总入账、totalOutcome-历史总出账。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/balance/my", |
|
"operationId": "myBalanceUsingGET", |
|
"parameters": [], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "用户积分账户", |
|
"name": "逻辑删除", |
|
"usage": "根据主键ID逻辑删除单条记录,成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/balance/removeById", |
|
"operationId": "deleteListUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "主键ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "用户积分账户", |
|
"name": "修改", |
|
"usage": "根据主键ID修改记录,请求体为实体类对象(需包含id字段)。成功返回 data 为 null。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/balance/updateById", |
|
"operationId": "updateByIdUsingPOST", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "用户积分账户" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "防刷分管控配置", |
|
"name": "获取启用的防刷配置", |
|
"usage": "返回 data 为 AntiFarmConfig 对象,包含当前生效的防刷规则配置。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/anti/farm/active", |
|
"operationId": "getActiveConfigUsingGET", |
|
"parameters": [], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "防刷分管控配置", |
|
"name": "新增", |
|
"usage": "新增单条记录,请求体为实体类对象(字段说明见对应实体模型)。成功返回 data 为 null。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/anti/farm/add", |
|
"operationId": "addOneUsingPOST_1", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "防刷分管控配置" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "防刷分管控配置", |
|
"name": "批量新增", |
|
"usage": "批量新增多条记录,请求体为实体类数组。成功返回 data 为 null。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/anti/farm/addBatch", |
|
"operationId": "addBatchUsingPOST_1", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "array<防刷分管控配置>" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "防刷分管控配置", |
|
"name": "新增并返回保存的数据", |
|
"usage": "新增单条记录并返回保存后的数据(含自增ID),请求体为实体类对象。成功返回 data 为保存的实体对象。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/anti/farm/addReturn", |
|
"operationId": "addReturnUsingPOST_1", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "防刷分管控配置" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "防刷分管控配置", |
|
"name": "根据属性删除", |
|
"usage": "根据实体属性条件删除记录,请求体为实体类对象。成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/anti/farm/delete", |
|
"operationId": "deleteUsingGET_1", |
|
"parameters": [ |
|
{ |
|
"name": "configName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "配置名称" |
|
}, |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "dailyPointsEarnLimit", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "每人每日积分获取上限" |
|
}, |
|
{ |
|
"name": "dailyReportLimit", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "每人每日上报次数上限" |
|
}, |
|
{ |
|
"name": "enabled", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "是否启用:1-启用 0-禁用" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "ipExchangeDailyLimit", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "同一IP每日兑换上限" |
|
}, |
|
{ |
|
"name": "remark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "备注" |
|
}, |
|
{ |
|
"name": "reportIntervalMinutes", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "两次上报最小间隔(分钟)" |
|
}, |
|
{ |
|
"name": "sameItemDailyLimit", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "同一商品每人每日兑换上限" |
|
}, |
|
{ |
|
"name": "sameLocationReportLimit", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "同一地点上报次数上限(每日)" |
|
}, |
|
{ |
|
"name": "sameReporterAuditLimit", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "同一上报人每日通过审核次数上限" |
|
}, |
|
{ |
|
"name": "selfReportCheckEnabled", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "是否启用自报自审检测:1-是 0-否" |
|
}, |
|
{ |
|
"name": "updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "更新时间" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "防刷分管控配置", |
|
"name": "主键删除", |
|
"usage": "根据主键ID删除单条记录,成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/anti/farm/deleteById", |
|
"operationId": "deleteOneUsingGET_1", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "主键ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "防刷分管控配置", |
|
"name": "批量删除", |
|
"usage": "根据ID列表批量删除记录,成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/anti/farm/deleteByIds", |
|
"operationId": "deleteListUsingGET_3", |
|
"parameters": [ |
|
{ |
|
"name": "ids", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "ID列表(逗号分隔)" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "防刷分管控配置", |
|
"name": "异常行为一键检测", |
|
"usage": "对指定用户执行全维度异常行为检测,聚合4类防刷校验(上报/积分获取/兑换)。返回 data 为对象,包含:userId-被检测用户ID、reportCheck-上报检测结果{passed-是否通过,reason-原因}、pointsEarnCheck-积分获取检测结果{passed,reason}、exchangeCheck-兑换检测结果{passed,reason}、overallPassed-综合是否通过(boolean)。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/anti/farm/detectAll", |
|
"operationId": "detectAllUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "userId", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int64", |
|
"description": "被检测用户ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "防刷分管控配置", |
|
"name": "检测自报自审行为", |
|
"usage": "检测上报人和审核人是否为同一人。返回 data 为字符串,检测到异常时返回'检测到自报自审行为',正常时返回'未检测到异常'。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/anti/farm/detectSelfAudit", |
|
"operationId": "detectSelfAuditUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "reporterId", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int64", |
|
"description": "上报人ID" |
|
}, |
|
{ |
|
"name": "auditorId", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int64", |
|
"description": "审核人ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "防刷分管控配置", |
|
"name": "查询所有", |
|
"usage": "查询所有记录(无分页、无条件)。成功返回 data 为实体类数组。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/anti/farm/getAll", |
|
"operationId": "getAllUsingGET_1", |
|
"parameters": [], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "防刷分管控配置", |
|
"name": "分页查询", |
|
"usage": "分页查询记录列表,查询条件为实体类字段。成功返回 data 为 PageInfo 分页对象,其中 list 为实体类数组。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/anti/farm/getListByPage", |
|
"operationId": "getListByPageUsingGET_1", |
|
"parameters": [ |
|
{ |
|
"name": "configName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "配置名称" |
|
}, |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "dailyPointsEarnLimit", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "每人每日积分获取上限" |
|
}, |
|
{ |
|
"name": "dailyReportLimit", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "每人每日上报次数上限" |
|
}, |
|
{ |
|
"name": "enabled", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "是否启用:1-启用 0-禁用" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "ipExchangeDailyLimit", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "同一IP每日兑换上限" |
|
}, |
|
{ |
|
"name": "pageNum", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "页码" |
|
}, |
|
{ |
|
"name": "remark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "备注" |
|
}, |
|
{ |
|
"name": "reportIntervalMinutes", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "两次上报最小间隔(分钟)" |
|
}, |
|
{ |
|
"name": "sameItemDailyLimit", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "同一商品每人每日兑换上限" |
|
}, |
|
{ |
|
"name": "sameLocationReportLimit", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "同一地点上报次数上限(每日)" |
|
}, |
|
{ |
|
"name": "sameReporterAuditLimit", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "同一上报人每日通过审核次数上限" |
|
}, |
|
{ |
|
"name": "selfReportCheckEnabled", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "是否启用自报自审检测:1-是 0-否" |
|
}, |
|
{ |
|
"name": "updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "更新时间" |
|
}, |
|
{ |
|
"name": "pageSize", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "每页条数" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "防刷分管控配置", |
|
"name": "详情", |
|
"usage": "根据主键ID查询单条记录详情。成功返回 data 为实体类对象,包含该实体所有字段。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/anti/farm/info", |
|
"operationId": "infoUsingGET_1", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "主键ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "防刷分管控配置", |
|
"name": "条件查询", |
|
"usage": "根据实体属性条件查询记录列表。成功返回 data 为实体类数组。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/anti/farm/list", |
|
"operationId": "getListUsingGET_1", |
|
"parameters": [ |
|
{ |
|
"name": "configName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "配置名称" |
|
}, |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "dailyPointsEarnLimit", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "每人每日积分获取上限" |
|
}, |
|
{ |
|
"name": "dailyReportLimit", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "每人每日上报次数上限" |
|
}, |
|
{ |
|
"name": "enabled", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "是否启用:1-启用 0-禁用" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "ipExchangeDailyLimit", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "同一IP每日兑换上限" |
|
}, |
|
{ |
|
"name": "remark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "备注" |
|
}, |
|
{ |
|
"name": "reportIntervalMinutes", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "两次上报最小间隔(分钟)" |
|
}, |
|
{ |
|
"name": "sameItemDailyLimit", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "同一商品每人每日兑换上限" |
|
}, |
|
{ |
|
"name": "sameLocationReportLimit", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "同一地点上报次数上限(每日)" |
|
}, |
|
{ |
|
"name": "sameReporterAuditLimit", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "同一上报人每日通过审核次数上限" |
|
}, |
|
{ |
|
"name": "selfReportCheckEnabled", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "是否启用自报自审检测:1-是 0-否" |
|
}, |
|
{ |
|
"name": "updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "更新时间" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "防刷分管控配置", |
|
"name": "逻辑删除", |
|
"usage": "根据主键ID逻辑删除单条记录,成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/anti/farm/removeById", |
|
"operationId": "deleteListUsingGET_2", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "主键ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "防刷分管控配置", |
|
"name": "修改", |
|
"usage": "根据主键ID修改记录,请求体为实体类对象(需包含id字段)。成功返回 data 为 null。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/anti/farm/updateById", |
|
"operationId": "updateByIdUsingPOST_1", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "防刷分管控配置" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "防刷分管控配置", |
|
"name": "校验兑换是否触发防刷", |
|
"usage": "返回 data 为对象,包含:triggered-是否触发、reason-触发原因。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/anti/farm/validateExchange", |
|
"operationId": "validateExchangeUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "userId", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int64", |
|
"description": "用户ID" |
|
}, |
|
{ |
|
"name": "itemId", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int64", |
|
"description": "物品ID" |
|
}, |
|
{ |
|
"name": "ip", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "IP地址" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "防刷分管控配置", |
|
"name": "校验积分获取是否触发防刷", |
|
"usage": "返回 data 为对象,包含:triggered-是否触发、reason-触发原因。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/anti/farm/validatePointsEarn", |
|
"operationId": "validatePointsEarnUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "reporterId", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int64", |
|
"description": "上报人ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "防刷分管控配置", |
|
"name": "校验上报是否触发防刷", |
|
"usage": "返回 data 为对象,包含:triggered-是否触发(boolean)、reason-触发原因。前端在上报前调用,若 triggered=true 则提示用户。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/anti/farm/validateReport", |
|
"operationId": "validateReportUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "userId", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int64", |
|
"description": "用户ID" |
|
}, |
|
{ |
|
"name": "location", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "上报地点" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "操作审计日志", |
|
"name": "新增", |
|
"usage": "新增单条记录,请求体为实体类对象(字段说明见对应实体模型)。成功返回 data 为 null。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/audit/log/add", |
|
"operationId": "addOneUsingPOST_2", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "操作审计日志" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "操作审计日志", |
|
"name": "批量新增", |
|
"usage": "批量新增多条记录,请求体为实体类数组。成功返回 data 为 null。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/audit/log/addBatch", |
|
"operationId": "addBatchUsingPOST_2", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "array<操作审计日志>" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "操作审计日志", |
|
"name": "新增并返回保存的数据", |
|
"usage": "新增单条记录并返回保存后的数据(含自增ID),请求体为实体类对象。成功返回 data 为保存的实体对象。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/audit/log/addReturn", |
|
"operationId": "addReturnUsingPOST_2", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "操作审计日志" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "操作审计日志", |
|
"name": "按业务单号查询审计日志", |
|
"usage": "根据业务单号(如隐患ID、订单ID)查询关联的所有审计日志,按时间倒序。返回 data 为 AuditLog 数组,每个元素包含:id、operator-操作人、operatorIp-操作人IP、operationType-操作类型(AUDIT_PASS/POINTS_ADJUST/EXCHANGE_REFUND)、bizId-业务单号、beforeData-操作前数据(JSON)、afterData-操作后数据(JSON)、remark-备注、createTime-操作时间。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/audit/log/biz/{bizId}", |
|
"operationId": "listByBizIdUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "bizId", |
|
"in": "path", |
|
"required": true, |
|
"type": "string", |
|
"description": "业务单号" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "操作审计日志", |
|
"name": "根据属性删除", |
|
"usage": "根据实体属性条件删除记录,请求体为实体类对象。成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/audit/log/delete", |
|
"operationId": "deleteUsingGET_2", |
|
"parameters": [ |
|
{ |
|
"name": "afterData", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作后数据(JSON)" |
|
}, |
|
{ |
|
"name": "beforeData", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作前数据(JSON)" |
|
}, |
|
{ |
|
"name": "bizId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "业务单号" |
|
}, |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "操作时间" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "operationType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作类型:AUDIT_PASS-审核通过 POINTS_ADJUST-积分调整 EXCHANGE_REFUND-兑换退款" |
|
}, |
|
{ |
|
"name": "operator", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作人" |
|
}, |
|
{ |
|
"name": "operatorIp", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作人IP地址" |
|
}, |
|
{ |
|
"name": "remark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作备注" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "操作审计日志", |
|
"name": "主键删除", |
|
"usage": "根据主键ID删除单条记录,成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/audit/log/deleteById", |
|
"operationId": "deleteOneUsingGET_2", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "主键ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "操作审计日志", |
|
"name": "批量删除", |
|
"usage": "根据ID列表批量删除记录,成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/audit/log/deleteByIds", |
|
"operationId": "deleteListUsingGET_5", |
|
"parameters": [ |
|
{ |
|
"name": "ids", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "ID列表(逗号分隔)" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "操作审计日志", |
|
"name": "查询所有", |
|
"usage": "查询所有记录(无分页、无条件)。成功返回 data 为实体类数组。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/audit/log/getAll", |
|
"operationId": "getAllUsingGET_2", |
|
"parameters": [], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "操作审计日志", |
|
"name": "分页查询", |
|
"usage": "分页查询记录列表,查询条件为实体类字段。成功返回 data 为 PageInfo 分页对象,其中 list 为实体类数组。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/audit/log/getListByPage", |
|
"operationId": "getListByPageUsingGET_2", |
|
"parameters": [ |
|
{ |
|
"name": "afterData", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作后数据(JSON)" |
|
}, |
|
{ |
|
"name": "beforeData", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作前数据(JSON)" |
|
}, |
|
{ |
|
"name": "bizId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "业务单号" |
|
}, |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "操作时间" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "operationType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作类型:AUDIT_PASS-审核通过 POINTS_ADJUST-积分调整 EXCHANGE_REFUND-兑换退款" |
|
}, |
|
{ |
|
"name": "operator", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作人" |
|
}, |
|
{ |
|
"name": "operatorIp", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作人IP地址" |
|
}, |
|
{ |
|
"name": "pageNum", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "页码" |
|
}, |
|
{ |
|
"name": "remark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作备注" |
|
}, |
|
{ |
|
"name": "pageSize", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "每页条数" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "操作审计日志", |
|
"name": "详情", |
|
"usage": "根据主键ID查询单条记录详情。成功返回 data 为实体类对象,包含该实体所有字段。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/audit/log/info", |
|
"operationId": "infoUsingGET_2", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "主键ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "操作审计日志", |
|
"name": "条件查询", |
|
"usage": "根据实体属性条件查询记录列表。成功返回 data 为实体类数组。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/audit/log/list", |
|
"operationId": "getListUsingGET_2", |
|
"parameters": [ |
|
{ |
|
"name": "afterData", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作后数据(JSON)" |
|
}, |
|
{ |
|
"name": "beforeData", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作前数据(JSON)" |
|
}, |
|
{ |
|
"name": "bizId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "业务单号" |
|
}, |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "操作时间" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "operationType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作类型:AUDIT_PASS-审核通过 POINTS_ADJUST-积分调整 EXCHANGE_REFUND-兑换退款" |
|
}, |
|
{ |
|
"name": "operator", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作人" |
|
}, |
|
{ |
|
"name": "operatorIp", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作人IP地址" |
|
}, |
|
{ |
|
"name": "remark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作备注" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "操作审计日志", |
|
"name": "逻辑删除", |
|
"usage": "根据主键ID逻辑删除单条记录,成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/audit/log/removeById", |
|
"operationId": "deleteListUsingGET_4", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "主键ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "操作审计日志", |
|
"name": "修改", |
|
"usage": "根据主键ID修改记录,请求体为实体类对象(需包含id字段)。成功返回 data 为 null。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/audit/log/updateById", |
|
"operationId": "updateByIdUsingPOST_2", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "操作审计日志" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "工作流流程_公用信息", |
|
"name": "获取流程详情", |
|
"usage": "根据流程实例ID查询流程详细信息,返回 data 包含流程节点、审批记录、当前状态等。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/busiInfo/getProcessDetail", |
|
"operationId": "getProcessDetailUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "流程实例ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "工作流流程_签字审批", |
|
"name": "审批任务", |
|
"usage": "审批通过或驳回,需携带taskId、result、comment等信息。成功返回 data 为 null;失败返回 error 信息。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/busiTask/complete", |
|
"operationId": "completeUsingPOST", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "工作流签字任务相关--请求参数" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "工作流流程_签字审批", |
|
"name": "获取当前节点信息", |
|
"usage": "根据任务ID查询当前节点详情,返回 data 为节点信息字符串。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/busiTask/getCurrentNode", |
|
"operationId": "getCurrentNodeUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "taskId", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "任务ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "common-controller", |
|
"name": "文件删除接口", |
|
"usage": "", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/common/deletefile", |
|
"operationId": "deletefileUsingPOST", |
|
"parameters": [ |
|
{ |
|
"name": "fileName", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "fileName" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "common-controller", |
|
"name": "文件删除接口", |
|
"usage": "", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/common/deletefilelist", |
|
"operationId": "deletefilelistUsingPOST", |
|
"parameters": [ |
|
{ |
|
"name": "fileNamelist", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "fileNamelist" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "数据分析", |
|
"name": "首页数据看板", |
|
"usage": "返回 data 为对象,包含:totalHazard-隐患总数、monthHazard-本月新增隐患、pendingHazard-待处理隐患、totalPoints-积分总量、monthPoints-本月发放积分、onTimeRate-准时率(%)、todayExchangeCount-今日兑换单数、todayPointsIssued-今日发放积分数。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/analysis/dashboard", |
|
"operationId": "dashboardUsingGET", |
|
"parameters": [], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "数据分析", |
|
"name": "隐患热力图-按部门统计", |
|
"usage": "返回 data 为数组,每个元素包含:departmentId-部门ID、departmentName-部门名称、hazardCount-隐患数量。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/analysis/heatmap/department", |
|
"operationId": "heatmapByDepartmentUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "unitId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "单位ID" |
|
}, |
|
{ |
|
"name": "startTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "开始时间(yyyy-MM-dd)" |
|
}, |
|
{ |
|
"name": "endTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "结束时间(yyyy-MM-dd)" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "数据分析", |
|
"name": "隐患热力图-按单位统计", |
|
"usage": "返回 data 为数组,每个元素包含:unitId-单位ID、unitName-单位名称、hazardCount-隐患数量。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/analysis/heatmap/unit", |
|
"operationId": "heatmapByUnitUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "startTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "开始时间(yyyy-MM-dd)" |
|
}, |
|
{ |
|
"name": "endTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "结束时间(yyyy-MM-dd)" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "数据分析", |
|
"name": "兑换排行统计(按单位)", |
|
"usage": "按单位统计兑换数据,仅统计兑换成功(status=2)的订单。返回 data 为数组,每个元素包含:unitId-单位ID、unitName-单位名称、orderCount-兑换单数、totalPoints-消耗积分总量、userCount-兑换人数。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/analysis/ranking/exchange", |
|
"operationId": "exchangeRankingByUnitUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "startTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "开始时间(yyyy-MM-dd)" |
|
}, |
|
{ |
|
"name": "endTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "结束时间(yyyy-MM-dd)" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "数据分析", |
|
"name": "积分排行榜-本月获取", |
|
"usage": "返回 data 为数组,每个元素包含:userId-用户ID、userName-用户姓名、monthIncome-本月获取积分、rank-排名。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/analysis/ranking/monthlyPoints", |
|
"operationId": "monthlyPointsRankingUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "topN", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "前N名" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "数据分析", |
|
"name": "我的积分排名(APP端)", |
|
"usage": "查询当前登录用户的积分排名,返回userId、totalIncome、rank", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/analysis/ranking/myRank", |
|
"operationId": "myRankUsingGET", |
|
"parameters": [], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "数据分析", |
|
"name": "积分排行榜-总入账", |
|
"usage": "返回 data 为数组,每个元素包含:userId-用户ID、userName-用户姓名、totalIncome-总入账积分、rank-排名。按 totalIncome 降序排列。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/analysis/ranking/points", |
|
"operationId": "pointsRankingUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "topN", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "前N名" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "数据分析", |
|
"name": "上报积分排行", |
|
"usage": "返回 data 为数组,每个元素包含:userId-用户ID、userName-用户姓名、reportCount-上报次数、rank-排名。按上报次数降序。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/analysis/ranking/report", |
|
"operationId": "reportPointsRankingUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "topN", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "前N名" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "数据分析", |
|
"name": "月度安全运营报告(JSON)", |
|
"usage": "查询指定月份的运营数据,支持查询全年或单月。month=0 表示查询全年各月数据,month=1~12 表示查询指定月份。返回 data 为 MonthlyReportVO 数组,每个元素包含:month-月份、hazardCount-隐患总数、approvedCount-已通过数、rejectedCount-已驳回数、pointsIssued-发放积分、avgProcessHours-平均处理时长(小时)、onTimeRate-准时率(%)、exchangeOrderCount-兑换单数、exchangePoints-兑换消耗积分。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/analysis/report/monthly", |
|
"operationId": "monthlyReportUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "year", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "年份" |
|
}, |
|
{ |
|
"name": "month", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "月份(0=全年,1-12=指定月)" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "数据分析", |
|
"name": "月度安全运营报告导出(Excel)", |
|
"usage": "导出指定月份的运营数据为 Excel 文件。month=0 表示导出全年各月数据,month=1~12 表示导出指定月份。直接下载 Excel 文件,无需解析返回数据。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/analysis/report/monthly/export", |
|
"operationId": "exportMonthlyReportUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "year", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "年份" |
|
}, |
|
{ |
|
"name": "month", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "月份(0=全年,1-12=指定月)" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "数据分析", |
|
"name": "隐患统计-按分类", |
|
"usage": "返回 data 为数组,每个元素包含:categoryName-隐患分类名称、count-数量。用于饼图展示。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/analysis/stats/category", |
|
"operationId": "statsByCategoryUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "startTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "开始时间(yyyy-MM-dd)" |
|
}, |
|
{ |
|
"name": "endTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "结束时间(yyyy-MM-dd)" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "数据分析", |
|
"name": "隐患统计-按级别", |
|
"usage": "返回 data 为数组,每个元素包含:levelName-隐患级别名称、count-数量。用于饼图展示。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/analysis/stats/level", |
|
"operationId": "statsByLevelUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "startTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "开始时间(yyyy-MM-dd)" |
|
}, |
|
{ |
|
"name": "endTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "结束时间(yyyy-MM-dd)" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "数据分析", |
|
"name": "处理时效-按级别", |
|
"usage": "返回 data 为数组,每个元素包含:levelName-级别名称、avgHours-平均处理时长、completedCount-已完成数。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/analysis/timeliness/level", |
|
"operationId": "timelinessByLevelUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "startTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "开始时间(yyyy-MM-dd)" |
|
}, |
|
{ |
|
"name": "endTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "结束时间(yyyy-MM-dd)" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "数据分析", |
|
"name": "超期未处理列表", |
|
"usage": "返回 data 为 HazardReport 数组,每条记录包含 id、reportNo、hazardName、unitName、hazardLevelName、limitedCompleteTime-限定完成时间、status-状态 等字段。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/analysis/timeliness/overdue", |
|
"operationId": "overdueListUsingGET", |
|
"parameters": [], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "数据分析", |
|
"name": "处理时效总览", |
|
"usage": "返回 data 为对象,包含:avgHours-平均处理时长(小时)、maxHours-最大处理时长、minHours-最小处理时长、onTimeRate-准时率(%)、totalCount-总隐患数、completedCount-已完成数、pendingCount-待处理数。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/analysis/timeliness/overview", |
|
"operationId": "timelinessOverviewUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "startTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "开始时间(yyyy-MM-dd)" |
|
}, |
|
{ |
|
"name": "endTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "结束时间(yyyy-MM-dd)" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "数据分析", |
|
"name": "处理时效-按单位", |
|
"usage": "返回 data 为数组,每个元素包含:unitName-单位名称、avgHours-平均处理时长、completedCount-已完成数。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/analysis/timeliness/unit", |
|
"operationId": "timelinessByUnitUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "startTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "开始时间(yyyy-MM-dd)" |
|
}, |
|
{ |
|
"name": "endTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "结束时间(yyyy-MM-dd)" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "数据分析", |
|
"name": "隐患趋势-按月份", |
|
"usage": "返回 data 为数组,每个元素包含:month-月份(如'2026-01')、count-当月隐患数量。用于折线图展示。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/analysis/trend/month", |
|
"operationId": "trendByMonthUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "year", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "年份" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换安全配置", |
|
"name": "获取当前启用的兑换配置", |
|
"usage": "无请求参数。返回 data 为 ExchangeConfig 对象(数据库无记录时返回默认配置)。字段:pointsRatio-积分比例(N积分=1元)、singleMaxPoints-单笔最大积分、singleMinPoints-单笔最小积分、dailyLimitPerUser-每人每日兑换上限、monthlyLimitPerUser-每月上限、yearlyLimitPerUser-每年上限、dailyOrderCountLimit-每日兑换次数上限、rapidExchangeThreshold-短时间兑换次数阈值、rapidExchangeWindowMinutes-快速兑换检测窗口(分钟)、largeAmountThreshold-大额预警阈值、largeAmountNeedApproval-大额是否需审批(1是/0否)、antiFarmEnabled-隐患上报防刷检测开关(1启用/0禁用)。当安全开关关闭(enabled=0)时返回 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/exchange/config/active", |
|
"operationId": "getActiveConfigUsingGET_1", |
|
"parameters": [], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换安全配置", |
|
"name": "新增", |
|
"usage": "新增单条记录,请求体为实体类对象(字段说明见对应实体模型)。成功返回 data 为 null。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/exchange/config/add", |
|
"operationId": "addOneUsingPOST_3", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "兑换安全配置" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换安全配置", |
|
"name": "批量新增", |
|
"usage": "批量新增多条记录,请求体为实体类数组。成功返回 data 为 null。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/exchange/config/addBatch", |
|
"operationId": "addBatchUsingPOST_3", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "array<兑换安全配置>" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换安全配置", |
|
"name": "新增并返回保存的数据", |
|
"usage": "新增单条记录并返回保存后的数据(含自增ID),请求体为实体类对象。成功返回 data 为保存的实体对象。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/exchange/config/addReturn", |
|
"operationId": "addReturnUsingPOST_3", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "兑换安全配置" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换安全配置", |
|
"name": "根据属性删除", |
|
"usage": "根据实体属性条件删除记录,请求体为实体类对象。成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/exchange/config/delete", |
|
"operationId": "deleteUsingGET_3", |
|
"parameters": [ |
|
{ |
|
"name": "antiFarmEnabled", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "隐患上报防刷检测是否启用:1-启用 0-禁用" |
|
}, |
|
{ |
|
"name": "configName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "配置名称" |
|
}, |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "dailyLimitPerUser", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "每人每日兑换上限(积分)" |
|
}, |
|
{ |
|
"name": "dailyOrderCountLimit", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "每人每日兑换次数上限" |
|
}, |
|
{ |
|
"name": "enabled", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "是否启用:1-启用 0-禁用" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "largeAmountNeedApproval", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "大额兑换是否需审批:1-是 0-否" |
|
}, |
|
{ |
|
"name": "largeAmountThreshold", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "大额兑换预警阈值(积分)" |
|
}, |
|
{ |
|
"name": "monthlyLimitPerUser", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "每人每月上限(积分)" |
|
}, |
|
{ |
|
"name": "pointsRatio", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "积分比例(N积分=1元)" |
|
}, |
|
{ |
|
"name": "rapidExchangeThreshold", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "短时间内兑换次数阈值(触发预警)" |
|
}, |
|
{ |
|
"name": "rapidExchangeWindowMinutes", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "快速兑换检测时间窗口(分钟)" |
|
}, |
|
{ |
|
"name": "remark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "备注" |
|
}, |
|
{ |
|
"name": "singleMaxPoints", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "单笔最大积分" |
|
}, |
|
{ |
|
"name": "singleMinPoints", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "单笔最小积分" |
|
}, |
|
{ |
|
"name": "updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "更新时间" |
|
}, |
|
{ |
|
"name": "yearlyLimitPerUser", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "每人每年上限(积分)" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换安全配置", |
|
"name": "主键删除", |
|
"usage": "根据主键ID删除单条记录,成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/exchange/config/deleteById", |
|
"operationId": "deleteOneUsingGET_3", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "主键ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换安全配置", |
|
"name": "批量删除", |
|
"usage": "根据ID列表批量删除记录,成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/exchange/config/deleteByIds", |
|
"operationId": "deleteListUsingGET_7", |
|
"parameters": [ |
|
{ |
|
"name": "ids", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "ID列表(逗号分隔)" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换安全配置", |
|
"name": "查询所有", |
|
"usage": "查询所有记录(无分页、无条件)。成功返回 data 为实体类数组。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/exchange/config/getAll", |
|
"operationId": "getAllUsingGET_3", |
|
"parameters": [], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换安全配置", |
|
"name": "分页查询", |
|
"usage": "分页查询记录列表,查询条件为实体类字段。成功返回 data 为 PageInfo 分页对象,其中 list 为实体类数组。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/exchange/config/getListByPage", |
|
"operationId": "getListByPageUsingGET_3", |
|
"parameters": [ |
|
{ |
|
"name": "antiFarmEnabled", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "隐患上报防刷检测是否启用:1-启用 0-禁用" |
|
}, |
|
{ |
|
"name": "configName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "配置名称" |
|
}, |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "dailyLimitPerUser", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "每人每日兑换上限(积分)" |
|
}, |
|
{ |
|
"name": "dailyOrderCountLimit", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "每人每日兑换次数上限" |
|
}, |
|
{ |
|
"name": "enabled", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "是否启用:1-启用 0-禁用" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "largeAmountNeedApproval", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "大额兑换是否需审批:1-是 0-否" |
|
}, |
|
{ |
|
"name": "largeAmountThreshold", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "大额兑换预警阈值(积分)" |
|
}, |
|
{ |
|
"name": "monthlyLimitPerUser", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "每人每月上限(积分)" |
|
}, |
|
{ |
|
"name": "pageNum", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "页码" |
|
}, |
|
{ |
|
"name": "pointsRatio", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "积分比例(N积分=1元)" |
|
}, |
|
{ |
|
"name": "rapidExchangeThreshold", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "短时间内兑换次数阈值(触发预警)" |
|
}, |
|
{ |
|
"name": "rapidExchangeWindowMinutes", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "快速兑换检测时间窗口(分钟)" |
|
}, |
|
{ |
|
"name": "remark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "备注" |
|
}, |
|
{ |
|
"name": "singleMaxPoints", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "单笔最大积分" |
|
}, |
|
{ |
|
"name": "singleMinPoints", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "单笔最小积分" |
|
}, |
|
{ |
|
"name": "updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "更新时间" |
|
}, |
|
{ |
|
"name": "yearlyLimitPerUser", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "每人每年上限(积分)" |
|
}, |
|
{ |
|
"name": "pageSize", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "每页条数" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换安全配置", |
|
"name": "详情", |
|
"usage": "根据主键ID查询单条记录详情。成功返回 data 为实体类对象,包含该实体所有字段。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/exchange/config/info", |
|
"operationId": "infoUsingGET_3", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "主键ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换安全配置", |
|
"name": "条件查询", |
|
"usage": "根据实体属性条件查询记录列表。成功返回 data 为实体类数组。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/exchange/config/list", |
|
"operationId": "getListUsingGET_3", |
|
"parameters": [ |
|
{ |
|
"name": "antiFarmEnabled", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "隐患上报防刷检测是否启用:1-启用 0-禁用" |
|
}, |
|
{ |
|
"name": "configName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "配置名称" |
|
}, |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "dailyLimitPerUser", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "每人每日兑换上限(积分)" |
|
}, |
|
{ |
|
"name": "dailyOrderCountLimit", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "每人每日兑换次数上限" |
|
}, |
|
{ |
|
"name": "enabled", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "是否启用:1-启用 0-禁用" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "largeAmountNeedApproval", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "大额兑换是否需审批:1-是 0-否" |
|
}, |
|
{ |
|
"name": "largeAmountThreshold", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "大额兑换预警阈值(积分)" |
|
}, |
|
{ |
|
"name": "monthlyLimitPerUser", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "每人每月上限(积分)" |
|
}, |
|
{ |
|
"name": "pointsRatio", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "积分比例(N积分=1元)" |
|
}, |
|
{ |
|
"name": "rapidExchangeThreshold", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "短时间内兑换次数阈值(触发预警)" |
|
}, |
|
{ |
|
"name": "rapidExchangeWindowMinutes", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "快速兑换检测时间窗口(分钟)" |
|
}, |
|
{ |
|
"name": "remark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "备注" |
|
}, |
|
{ |
|
"name": "singleMaxPoints", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "单笔最大积分" |
|
}, |
|
{ |
|
"name": "singleMinPoints", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "单笔最小积分" |
|
}, |
|
{ |
|
"name": "updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "更新时间" |
|
}, |
|
{ |
|
"name": "yearlyLimitPerUser", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "每人每年上限(积分)" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换安全配置", |
|
"name": "逻辑删除", |
|
"usage": "根据主键ID逻辑删除单条记录,成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/exchange/config/removeById", |
|
"operationId": "deleteListUsingGET_6", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "主键ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换安全配置", |
|
"name": "查询兑换安全开关状态", |
|
"usage": "无请求参数。返回 data 为 boolean,true-启用安全校验,false-已关闭。判断逻辑:数据库无配置记录时默认启用;有记录时根据 enabled 字段(1启用/0禁用)决定。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/exchange/config/switch/status", |
|
"operationId": "getSwitchStatusUsingGET", |
|
"parameters": [], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换安全配置", |
|
"name": "切换兑换安全开关(管理端)", |
|
"usage": "请求参数:enabled-true启用/false禁用(Boolean,必填)。返回 data 为 boolean,true-切换成功,false-切换失败。若数据库无配置记录且传入true,会自动创建默认配置。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/exchange/config/switch/toggle", |
|
"operationId": "toggleSwitchUsingPOST", |
|
"parameters": [ |
|
{ |
|
"name": "enabled", |
|
"in": "query", |
|
"required": true, |
|
"type": "boolean", |
|
"description": "true-启用安全校验,false-禁用" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换安全配置", |
|
"name": "修改", |
|
"usage": "根据主键ID修改记录,请求体为实体类对象(需包含id字段)。成功返回 data 为 null。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/exchange/config/updateById", |
|
"operationId": "updateByIdUsingPOST_3", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "兑换安全配置" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换安全配置", |
|
"name": "校验兑换请求(APP端)", |
|
"usage": "在下单前调用,校验是否满足安全规则。请求参数:totalPoints-兑换总积分(int,必填)。返回 data 为对象,包含:passed-是否通过(boolean)、errors-错误信息数组(如'单笔兑换不能超过5000积分')、warnings-警告信息数组、securityEnabled-安全开关是否启用(boolean)、config-当前启用的兑换配置对象(开关关闭时为null)。前端根据 passed 判断能否兑换,errors 为空表示校验通过。当安全开关关闭时,passed=true、securityEnabled=false。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/exchange/config/validate", |
|
"operationId": "validateExchangeUsingPOST", |
|
"parameters": [ |
|
{ |
|
"name": "totalPoints", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "兑换总积分" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换物品管理", |
|
"name": "新增", |
|
"usage": "新增单条记录,请求体为实体类对象(字段说明见对应实体模型)。成功返回 data 为 null。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/exchange/item/add", |
|
"operationId": "addOneUsingPOST_4", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "兑换物品" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换物品管理", |
|
"name": "批量新增", |
|
"usage": "批量新增多条记录,请求体为实体类数组。成功返回 data 为 null。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/exchange/item/addBatch", |
|
"operationId": "addBatchUsingPOST_4", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "array<兑换物品>" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换物品管理", |
|
"name": "新增并返回保存的数据", |
|
"usage": "新增单条记录并返回保存后的数据(含自增ID),请求体为实体类对象。成功返回 data 为保存的实体对象。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/exchange/item/addReturn", |
|
"operationId": "addReturnUsingPOST_4", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "兑换物品" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换物品管理", |
|
"name": "根据属性删除", |
|
"usage": "根据实体属性条件删除记录,请求体为实体类对象。成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/exchange/item/delete", |
|
"operationId": "deleteUsingGET_4", |
|
"parameters": [ |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "dailyLimitPerUser", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "每人每日兑换上限(0表示无限制)" |
|
}, |
|
{ |
|
"name": "description", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "物品描述" |
|
}, |
|
{ |
|
"name": "externalLink", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "第三方兑换链接" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "itemCode", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "物品编码" |
|
}, |
|
{ |
|
"name": "itemName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "物品名称" |
|
}, |
|
{ |
|
"name": "pointsRequired", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "所需积分" |
|
}, |
|
{ |
|
"name": "sortOrder", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "排序权重" |
|
}, |
|
{ |
|
"name": "status", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "状态:0-下架 1-上架" |
|
}, |
|
{ |
|
"name": "stock", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "库存数量(0表示无限)" |
|
}, |
|
{ |
|
"name": "thirdPartyCode", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "第三方平台物品编码" |
|
}, |
|
{ |
|
"name": "updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "更新时间" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换物品管理", |
|
"name": "主键删除", |
|
"usage": "根据主键ID删除单条记录,成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/exchange/item/deleteById", |
|
"operationId": "deleteOneUsingGET_4", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "主键ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换物品管理", |
|
"name": "批量删除", |
|
"usage": "根据ID列表批量删除记录,成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/exchange/item/deleteByIds", |
|
"operationId": "deleteListUsingGET_9", |
|
"parameters": [ |
|
{ |
|
"name": "ids", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "ID列表(逗号分隔)" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换物品管理", |
|
"name": "查询所有", |
|
"usage": "查询所有记录(无分页、无条件)。成功返回 data 为实体类数组。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/exchange/item/getAll", |
|
"operationId": "getAllUsingGET_4", |
|
"parameters": [], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换物品管理", |
|
"name": "分页查询", |
|
"usage": "分页查询记录列表,查询条件为实体类字段。成功返回 data 为 PageInfo 分页对象,其中 list 为实体类数组。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/exchange/item/getListByPage", |
|
"operationId": "getListByPageUsingGET_4", |
|
"parameters": [ |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "dailyLimitPerUser", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "每人每日兑换上限(0表示无限制)" |
|
}, |
|
{ |
|
"name": "description", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "物品描述" |
|
}, |
|
{ |
|
"name": "externalLink", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "第三方兑换链接" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "itemCode", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "物品编码" |
|
}, |
|
{ |
|
"name": "itemName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "物品名称" |
|
}, |
|
{ |
|
"name": "pageNum", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "页码" |
|
}, |
|
{ |
|
"name": "pointsRequired", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "所需积分" |
|
}, |
|
{ |
|
"name": "sortOrder", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "排序权重" |
|
}, |
|
{ |
|
"name": "status", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "状态:0-下架 1-上架" |
|
}, |
|
{ |
|
"name": "stock", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "库存数量(0表示无限)" |
|
}, |
|
{ |
|
"name": "thirdPartyCode", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "第三方平台物品编码" |
|
}, |
|
{ |
|
"name": "updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "更新时间" |
|
}, |
|
{ |
|
"name": "pageSize", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "每页条数" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换物品管理", |
|
"name": "详情", |
|
"usage": "根据主键ID查询单条记录详情。成功返回 data 为实体类对象,包含该实体所有字段。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/exchange/item/info", |
|
"operationId": "infoUsingGET_4", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "主键ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换物品管理", |
|
"name": "条件查询", |
|
"usage": "根据实体属性条件查询记录列表。成功返回 data 为实体类数组。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/exchange/item/list", |
|
"operationId": "getListUsingGET_4", |
|
"parameters": [ |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "dailyLimitPerUser", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "每人每日兑换上限(0表示无限制)" |
|
}, |
|
{ |
|
"name": "description", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "物品描述" |
|
}, |
|
{ |
|
"name": "externalLink", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "第三方兑换链接" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "itemCode", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "物品编码" |
|
}, |
|
{ |
|
"name": "itemName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "物品名称" |
|
}, |
|
{ |
|
"name": "pointsRequired", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "所需积分" |
|
}, |
|
{ |
|
"name": "sortOrder", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "排序权重" |
|
}, |
|
{ |
|
"name": "status", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "状态:0-下架 1-上架" |
|
}, |
|
{ |
|
"name": "stock", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "库存数量(0表示无限)" |
|
}, |
|
{ |
|
"name": "thirdPartyCode", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "第三方平台物品编码" |
|
}, |
|
{ |
|
"name": "updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "更新时间" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换物品管理", |
|
"name": "查询上架物品列表", |
|
"usage": "前端展示用,返回 status=1 的物品,按 sortOrder 降序。返回 data 为 ExchangeItem 数组,每个元素包含:id、itemName-物品名称、itemPrice-所需积分、itemImage-物品图片URL、description-描述、stock-库存。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/exchange/item/listOnShelf", |
|
"operationId": "listOnShelfUsingGET", |
|
"parameters": [], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换物品管理", |
|
"name": "逻辑删除", |
|
"usage": "根据主键ID逻辑删除单条记录,成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/exchange/item/removeById", |
|
"operationId": "deleteListUsingGET_8", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "主键ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换物品管理", |
|
"name": "修改", |
|
"usage": "根据主键ID修改记录,请求体为实体类对象(需包含id字段)。成功返回 data 为 null。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/exchange/item/updateById", |
|
"operationId": "updateByIdUsingPOST_4", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "兑换物品" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换物品管理", |
|
"name": "上下架操作", |
|
"usage": "status=0 下架,status=1 上架。返回 data 为 boolean。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/exchange/item/updateStatus", |
|
"operationId": "updateStatusUsingPOST", |
|
"parameters": [ |
|
{ |
|
"name": "itemId", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int64", |
|
"description": "物品ID" |
|
}, |
|
{ |
|
"name": "status", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "状态:0-下架 1-上架" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换操作日志", |
|
"name": "新增", |
|
"usage": "新增单条记录,请求体为实体类对象(字段说明见对应实体模型)。成功返回 data 为 null。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/operation/log/add", |
|
"operationId": "addOneUsingPOST_5", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "兑换操作日志" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换操作日志", |
|
"name": "批量新增", |
|
"usage": "批量新增多条记录,请求体为实体类数组。成功返回 data 为 null。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/operation/log/addBatch", |
|
"operationId": "addBatchUsingPOST_5", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "array<兑换操作日志>" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换操作日志", |
|
"name": "新增并返回保存的数据", |
|
"usage": "新增单条记录并返回保存后的数据(含自增ID),请求体为实体类对象。成功返回 data 为保存的实体对象。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/operation/log/addReturn", |
|
"operationId": "addReturnUsingPOST_5", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "兑换操作日志" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换操作日志", |
|
"name": "根据属性删除", |
|
"usage": "根据实体属性条件删除记录,请求体为实体类对象。成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/operation/log/delete", |
|
"operationId": "deleteUsingGET_5", |
|
"parameters": [ |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "durationMs", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "耗时(毫秒)" |
|
}, |
|
{ |
|
"name": "errorMsg", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "错误信息" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "ipAddress", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作IP" |
|
}, |
|
{ |
|
"name": "operationDesc", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作描述" |
|
}, |
|
{ |
|
"name": "operationType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作类型:VIEW/VALIDATE/CREATE/FREEZE/UNFREEZE/DEDUCT/SUBMIT/CANCEL/REFUND/RETRY" |
|
}, |
|
{ |
|
"name": "orderId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "关联订单ID" |
|
}, |
|
{ |
|
"name": "orderNo", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "关联订单号" |
|
}, |
|
{ |
|
"name": "requestParams", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "请求参数(JSON)" |
|
}, |
|
{ |
|
"name": "responseResult", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "响应结果(JSON)" |
|
}, |
|
{ |
|
"name": "status", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作结果:SUCCESS/FAIL" |
|
}, |
|
{ |
|
"name": "userAgent", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "客户端UA" |
|
}, |
|
{ |
|
"name": "userId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "操作用户ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换操作日志", |
|
"name": "主键删除", |
|
"usage": "根据主键ID删除单条记录,成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/operation/log/deleteById", |
|
"operationId": "deleteOneUsingGET_5", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "主键ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换操作日志", |
|
"name": "批量删除", |
|
"usage": "根据ID列表批量删除记录,成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/operation/log/deleteByIds", |
|
"operationId": "deleteListUsingGET_11", |
|
"parameters": [ |
|
{ |
|
"name": "ids", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "ID列表(逗号分隔)" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换操作日志", |
|
"name": "查询所有", |
|
"usage": "查询所有记录(无分页、无条件)。成功返回 data 为实体类数组。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/operation/log/getAll", |
|
"operationId": "getAllUsingGET_5", |
|
"parameters": [], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换操作日志", |
|
"name": "分页查询", |
|
"usage": "分页查询记录列表,查询条件为实体类字段。成功返回 data 为 PageInfo 分页对象,其中 list 为实体类数组。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/operation/log/getListByPage", |
|
"operationId": "getListByPageUsingGET_5", |
|
"parameters": [ |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "durationMs", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "耗时(毫秒)" |
|
}, |
|
{ |
|
"name": "errorMsg", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "错误信息" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "ipAddress", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作IP" |
|
}, |
|
{ |
|
"name": "operationDesc", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作描述" |
|
}, |
|
{ |
|
"name": "operationType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作类型:VIEW/VALIDATE/CREATE/FREEZE/UNFREEZE/DEDUCT/SUBMIT/CANCEL/REFUND/RETRY" |
|
}, |
|
{ |
|
"name": "orderId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "关联订单ID" |
|
}, |
|
{ |
|
"name": "orderNo", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "关联订单号" |
|
}, |
|
{ |
|
"name": "pageNum", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "页码" |
|
}, |
|
{ |
|
"name": "requestParams", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "请求参数(JSON)" |
|
}, |
|
{ |
|
"name": "responseResult", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "响应结果(JSON)" |
|
}, |
|
{ |
|
"name": "status", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作结果:SUCCESS/FAIL" |
|
}, |
|
{ |
|
"name": "userAgent", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "客户端UA" |
|
}, |
|
{ |
|
"name": "userId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "操作用户ID" |
|
}, |
|
{ |
|
"name": "pageSize", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "每页条数" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换操作日志", |
|
"name": "详情", |
|
"usage": "根据主键ID查询单条记录详情。成功返回 data 为实体类对象,包含该实体所有字段。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/operation/log/info", |
|
"operationId": "infoUsingGET_5", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "主键ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换操作日志", |
|
"name": "条件查询", |
|
"usage": "根据实体属性条件查询记录列表。成功返回 data 为实体类数组。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/operation/log/list", |
|
"operationId": "getListUsingGET_5", |
|
"parameters": [ |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "durationMs", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "耗时(毫秒)" |
|
}, |
|
{ |
|
"name": "errorMsg", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "错误信息" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "ipAddress", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作IP" |
|
}, |
|
{ |
|
"name": "operationDesc", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作描述" |
|
}, |
|
{ |
|
"name": "operationType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作类型:VIEW/VALIDATE/CREATE/FREEZE/UNFREEZE/DEDUCT/SUBMIT/CANCEL/REFUND/RETRY" |
|
}, |
|
{ |
|
"name": "orderId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "关联订单ID" |
|
}, |
|
{ |
|
"name": "orderNo", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "关联订单号" |
|
}, |
|
{ |
|
"name": "requestParams", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "请求参数(JSON)" |
|
}, |
|
{ |
|
"name": "responseResult", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "响应结果(JSON)" |
|
}, |
|
{ |
|
"name": "status", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作结果:SUCCESS/FAIL" |
|
}, |
|
{ |
|
"name": "userAgent", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "客户端UA" |
|
}, |
|
{ |
|
"name": "userId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "操作用户ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换操作日志", |
|
"name": "查询订单操作日志", |
|
"usage": "返回 data 为 ExchangeOperationLog 数组,字段同上。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/operation/log/order/{orderId}", |
|
"operationId": "getLogsByOrderIdUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "orderId", |
|
"in": "path", |
|
"required": true, |
|
"type": "integer / int64", |
|
"description": "订单ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换操作日志", |
|
"name": "逻辑删除", |
|
"usage": "根据主键ID逻辑删除单条记录,成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/operation/log/removeById", |
|
"operationId": "deleteListUsingGET_10", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "主键ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换操作日志", |
|
"name": "修改", |
|
"usage": "根据主键ID修改记录,请求体为实体类对象(需包含id字段)。成功返回 data 为 null。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/operation/log/updateById", |
|
"operationId": "updateByIdUsingPOST_5", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "兑换操作日志" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换操作日志", |
|
"name": "查询用户操作日志", |
|
"usage": "返回 data 为 ExchangeOperationLog 数组,每个元素包含:id、userId-用户ID、orderId-订单ID、orderNo-订单号、operationType-操作类型、operationDetail-操作详情、result-结果、createTime。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/operation/log/user/{userId}", |
|
"operationId": "getLogsByUserIdUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "userId", |
|
"in": "path", |
|
"required": true, |
|
"type": "integer / int64", |
|
"description": "用户ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分兑换订单管理", |
|
"name": "新增", |
|
"usage": "新增单条记录,请求体为实体类对象(字段说明见对应实体模型)。成功返回 data 为 null。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/exchange/order/add", |
|
"operationId": "addOneUsingPOST_6", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "积分兑换订单" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分兑换订单管理", |
|
"name": "批量新增", |
|
"usage": "批量新增多条记录,请求体为实体类数组。成功返回 data 为 null。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/exchange/order/addBatch", |
|
"operationId": "addBatchUsingPOST_6", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "array<积分兑换订单>" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分兑换订单管理", |
|
"name": "新增并返回保存的数据", |
|
"usage": "新增单条记录并返回保存后的数据(含自增ID),请求体为实体类对象。成功返回 data 为保存的实体对象。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/exchange/order/addReturn", |
|
"operationId": "addReturnUsingPOST_6", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "积分兑换订单" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分兑换订单管理", |
|
"name": "根据属性删除", |
|
"usage": "根据实体属性条件删除记录,请求体为实体类对象。成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/exchange/order/delete", |
|
"operationId": "deleteUsingGET_6", |
|
"parameters": [ |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "finishTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "完成时间" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "itemId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "兑换物品ID" |
|
}, |
|
{ |
|
"name": "itemName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "物品名称" |
|
}, |
|
{ |
|
"name": "itemPrice", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "兑换所需积分" |
|
}, |
|
{ |
|
"name": "orderNo", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "订单号" |
|
}, |
|
{ |
|
"name": "quantity", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "兑换数量" |
|
}, |
|
{ |
|
"name": "status", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "订单状态:0-待处理 1-处理中 2-兑换成功 3-兑换失败 4-已退款 5-已关闭" |
|
}, |
|
{ |
|
"name": "thirdPartyOrderId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "第三方平台订单号" |
|
}, |
|
{ |
|
"name": "thirdPartyResponse", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "第三方回调原始数据" |
|
}, |
|
{ |
|
"name": "totalPoints", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "总消耗积分" |
|
}, |
|
{ |
|
"name": "updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "更新时间" |
|
}, |
|
{ |
|
"name": "userId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "用户ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分兑换订单管理", |
|
"name": "主键删除", |
|
"usage": "根据主键ID删除单条记录,成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/exchange/order/deleteById", |
|
"operationId": "deleteOneUsingGET_6", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "主键ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分兑换订单管理", |
|
"name": "批量删除", |
|
"usage": "根据ID列表批量删除记录,成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/exchange/order/deleteByIds", |
|
"operationId": "deleteListUsingGET_13", |
|
"parameters": [ |
|
{ |
|
"name": "ids", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "ID列表(逗号分隔)" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分兑换订单管理", |
|
"name": "查询所有", |
|
"usage": "查询所有记录(无分页、无条件)。成功返回 data 为实体类数组。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/exchange/order/getAll", |
|
"operationId": "getAllUsingGET_6", |
|
"parameters": [], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分兑换订单管理", |
|
"name": "分页查询", |
|
"usage": "分页查询记录列表,查询条件为实体类字段。成功返回 data 为 PageInfo 分页对象,其中 list 为实体类数组。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/exchange/order/getListByPage", |
|
"operationId": "getListByPageUsingGET_6", |
|
"parameters": [ |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "finishTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "完成时间" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "itemId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "兑换物品ID" |
|
}, |
|
{ |
|
"name": "itemName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "物品名称" |
|
}, |
|
{ |
|
"name": "itemPrice", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "兑换所需积分" |
|
}, |
|
{ |
|
"name": "orderNo", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "订单号" |
|
}, |
|
{ |
|
"name": "pageNum", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "页码" |
|
}, |
|
{ |
|
"name": "quantity", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "兑换数量" |
|
}, |
|
{ |
|
"name": "status", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "订单状态:0-待处理 1-处理中 2-兑换成功 3-兑换失败 4-已退款 5-已关闭" |
|
}, |
|
{ |
|
"name": "thirdPartyOrderId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "第三方平台订单号" |
|
}, |
|
{ |
|
"name": "thirdPartyResponse", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "第三方回调原始数据" |
|
}, |
|
{ |
|
"name": "totalPoints", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "总消耗积分" |
|
}, |
|
{ |
|
"name": "updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "更新时间" |
|
}, |
|
{ |
|
"name": "userId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "用户ID" |
|
}, |
|
{ |
|
"name": "pageSize", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "每页条数" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分兑换订单管理", |
|
"name": "详情", |
|
"usage": "根据主键ID查询单条记录详情。成功返回 data 为实体类对象,包含该实体所有字段。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/exchange/order/info", |
|
"operationId": "infoUsingGET_6", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "主键ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分兑换订单管理", |
|
"name": "条件查询", |
|
"usage": "根据实体属性条件查询记录列表。成功返回 data 为实体类数组。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/exchange/order/list", |
|
"operationId": "getListUsingGET_6", |
|
"parameters": [ |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "finishTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "完成时间" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "itemId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "兑换物品ID" |
|
}, |
|
{ |
|
"name": "itemName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "物品名称" |
|
}, |
|
{ |
|
"name": "itemPrice", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "兑换所需积分" |
|
}, |
|
{ |
|
"name": "orderNo", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "订单号" |
|
}, |
|
{ |
|
"name": "quantity", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "兑换数量" |
|
}, |
|
{ |
|
"name": "status", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "订单状态:0-待处理 1-处理中 2-兑换成功 3-兑换失败 4-已退款 5-已关闭" |
|
}, |
|
{ |
|
"name": "thirdPartyOrderId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "第三方平台订单号" |
|
}, |
|
{ |
|
"name": "thirdPartyResponse", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "第三方回调原始数据" |
|
}, |
|
{ |
|
"name": "totalPoints", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "总消耗积分" |
|
}, |
|
{ |
|
"name": "updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "更新时间" |
|
}, |
|
{ |
|
"name": "userId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "用户ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分兑换订单管理", |
|
"name": "查询我的兑换记录(APP端)", |
|
"usage": "返回 data 为 PageInfo 分页对象。list 中每条记录为 ExchangeOrder 对象,主要字段:id、orderNo-订单号、userId-用户ID、itemName-物品名称、itemPrice-单价积分、quantity-数量、totalPoints-总消耗积分、status-订单状态(0待处理/1处理中/2兑换成功/3兑换失败/4已退款/5已关闭)、createTime-创建时间、finishTime-完成时间。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/exchange/order/myList", |
|
"operationId": "myListUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "finishTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "完成时间" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "itemId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "兑换物品ID" |
|
}, |
|
{ |
|
"name": "itemName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "物品名称" |
|
}, |
|
{ |
|
"name": "itemPrice", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "兑换所需积分" |
|
}, |
|
{ |
|
"name": "orderNo", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "订单号" |
|
}, |
|
{ |
|
"name": "pageNum", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "页码" |
|
}, |
|
{ |
|
"name": "quantity", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "兑换数量" |
|
}, |
|
{ |
|
"name": "status", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "订单状态:0-待处理 1-处理中 2-兑换成功 3-兑换失败 4-已退款 5-已关闭" |
|
}, |
|
{ |
|
"name": "thirdPartyOrderId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "第三方平台订单号" |
|
}, |
|
{ |
|
"name": "thirdPartyResponse", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "第三方回调原始数据" |
|
}, |
|
{ |
|
"name": "totalPoints", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "总消耗积分" |
|
}, |
|
{ |
|
"name": "updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "更新时间" |
|
}, |
|
{ |
|
"name": "userId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "用户ID" |
|
}, |
|
{ |
|
"name": "pageSize", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "每页数量" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分兑换订单管理", |
|
"name": "退款(管理端操作)", |
|
"usage": "将订单状态改为已退款(4),并退回积分到用户账户。返回 data 为 boolean。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/exchange/order/refund/{orderId}", |
|
"operationId": "refundOrderUsingPOST", |
|
"parameters": [ |
|
{ |
|
"name": "orderId", |
|
"in": "path", |
|
"required": true, |
|
"type": "integer / int64", |
|
"description": "订单ID" |
|
}, |
|
{ |
|
"name": "operator", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "操作人" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分兑换订单管理", |
|
"name": "逻辑删除", |
|
"usage": "根据主键ID逻辑删除单条记录,成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/exchange/order/removeById", |
|
"operationId": "deleteListUsingGET_12", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "主键ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分兑换订单管理", |
|
"name": "修改", |
|
"usage": "根据主键ID修改记录,请求体为实体类对象(需包含id字段)。成功返回 data 为 null。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/exchange/order/updateById", |
|
"operationId": "updateByIdUsingPOST_6", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "积分兑换订单" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换订单追踪", |
|
"name": "新增", |
|
"usage": "新增单条记录,请求体为实体类对象(字段说明见对应实体模型)。成功返回 data 为 null。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/order/track/add", |
|
"operationId": "addOneUsingPOST_7", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "兑换订单追踪" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换订单追踪", |
|
"name": "批量新增", |
|
"usage": "批量新增多条记录,请求体为实体类数组。成功返回 data 为 null。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/order/track/addBatch", |
|
"operationId": "addBatchUsingPOST_7", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "array<兑换订单追踪>" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换订单追踪", |
|
"name": "新增并返回保存的数据", |
|
"usage": "新增单条记录并返回保存后的数据(含自增ID),请求体为实体类对象。成功返回 data 为保存的实体对象。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/order/track/addReturn", |
|
"operationId": "addReturnUsingPOST_7", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "兑换订单追踪" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换订单追踪", |
|
"name": "根据属性删除", |
|
"usage": "根据实体属性条件删除记录,请求体为实体类对象。成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/order/track/delete", |
|
"operationId": "deleteUsingGET_7", |
|
"parameters": [ |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "fromStatus", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "变更前状态" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "ipAddress", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作IP" |
|
}, |
|
{ |
|
"name": "operateType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作类型:CREATE/FREEZE/UNFREEZE/DEDUCT/SUBMIT/CANCEL/REFUND/RETRY" |
|
}, |
|
{ |
|
"name": "operator", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作人" |
|
}, |
|
{ |
|
"name": "orderId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "订单ID" |
|
}, |
|
{ |
|
"name": "orderNo", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "订单号" |
|
}, |
|
{ |
|
"name": "remark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作备注" |
|
}, |
|
{ |
|
"name": "statusName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "状态名称" |
|
}, |
|
{ |
|
"name": "toStatus", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "变更后状态" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换订单追踪", |
|
"name": "主键删除", |
|
"usage": "根据主键ID删除单条记录,成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/order/track/deleteById", |
|
"operationId": "deleteOneUsingGET_7", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "主键ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换订单追踪", |
|
"name": "批量删除", |
|
"usage": "根据ID列表批量删除记录,成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/order/track/deleteByIds", |
|
"operationId": "deleteListUsingGET_15", |
|
"parameters": [ |
|
{ |
|
"name": "ids", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "ID列表(逗号分隔)" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换订单追踪", |
|
"name": "查询所有", |
|
"usage": "查询所有记录(无分页、无条件)。成功返回 data 为实体类数组。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/order/track/getAll", |
|
"operationId": "getAllUsingGET_7", |
|
"parameters": [], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换订单追踪", |
|
"name": "分页查询", |
|
"usage": "分页查询记录列表,查询条件为实体类字段。成功返回 data 为 PageInfo 分页对象,其中 list 为实体类数组。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/order/track/getListByPage", |
|
"operationId": "getListByPageUsingGET_7", |
|
"parameters": [ |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "fromStatus", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "变更前状态" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "ipAddress", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作IP" |
|
}, |
|
{ |
|
"name": "operateType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作类型:CREATE/FREEZE/UNFREEZE/DEDUCT/SUBMIT/CANCEL/REFUND/RETRY" |
|
}, |
|
{ |
|
"name": "operator", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作人" |
|
}, |
|
{ |
|
"name": "orderId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "订单ID" |
|
}, |
|
{ |
|
"name": "orderNo", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "订单号" |
|
}, |
|
{ |
|
"name": "pageNum", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "页码" |
|
}, |
|
{ |
|
"name": "remark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作备注" |
|
}, |
|
{ |
|
"name": "statusName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "状态名称" |
|
}, |
|
{ |
|
"name": "toStatus", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "变更后状态" |
|
}, |
|
{ |
|
"name": "pageSize", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "每页条数" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换订单追踪", |
|
"name": "详情", |
|
"usage": "根据主键ID查询单条记录详情。成功返回 data 为实体类对象,包含该实体所有字段。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/order/track/info", |
|
"operationId": "infoUsingGET_7", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "主键ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换订单追踪", |
|
"name": "条件查询", |
|
"usage": "根据实体属性条件查询记录列表。成功返回 data 为实体类数组。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/order/track/list", |
|
"operationId": "getListUsingGET_7", |
|
"parameters": [ |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "fromStatus", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "变更前状态" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "ipAddress", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作IP" |
|
}, |
|
{ |
|
"name": "operateType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作类型:CREATE/FREEZE/UNFREEZE/DEDUCT/SUBMIT/CANCEL/REFUND/RETRY" |
|
}, |
|
{ |
|
"name": "operator", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作人" |
|
}, |
|
{ |
|
"name": "orderId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "订单ID" |
|
}, |
|
{ |
|
"name": "orderNo", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "订单号" |
|
}, |
|
{ |
|
"name": "remark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作备注" |
|
}, |
|
{ |
|
"name": "statusName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "状态名称" |
|
}, |
|
{ |
|
"name": "toStatus", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "变更后状态" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换订单追踪", |
|
"name": "查询订单追踪记录(按订单ID)", |
|
"usage": "返回 data 为 ExchangeOrderTrack 数组,每个元素包含:id、orderId-订单ID、orderNo-订单号、fromStatus-原状态、toStatus-新状态、trackType-追踪类型、remark-备注、operator-操作人、createTime-操作时间。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/order/track/list/{orderId}", |
|
"operationId": "getTracksByOrderIdUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "orderId", |
|
"in": "path", |
|
"required": true, |
|
"type": "integer / int64", |
|
"description": "订单ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换订单追踪", |
|
"name": "查询订单追踪记录(按订单号)", |
|
"usage": "返回 data 为 ExchangeOrderTrack 数组,字段同上。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/order/track/listByNo/{orderNo}", |
|
"operationId": "getTracksByOrderNoUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "orderNo", |
|
"in": "path", |
|
"required": true, |
|
"type": "string", |
|
"description": "订单号" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换订单追踪", |
|
"name": "逻辑删除", |
|
"usage": "根据主键ID逻辑删除单条记录,成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/order/track/removeById", |
|
"operationId": "deleteListUsingGET_14", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "主键ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "兑换订单追踪", |
|
"name": "修改", |
|
"usage": "根据主键ID修改记录,请求体为实体类对象(需包含id字段)。成功返回 data 为 null。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/order/track/updateById", |
|
"operationId": "updateByIdUsingPOST_7", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "兑换订单追踪" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "流程定义", |
|
"name": "指定流程达式列表", |
|
"usage": "", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/definition/expList", |
|
"operationId": "expListUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "createBy", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "createByName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "expression", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "name", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "params", |
|
"in": "query", |
|
"required": false, |
|
"type": "object", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "remark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "searchValue", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "status", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "updateBy", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "updateByName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "流程定义", |
|
"name": "导入流程文件", |
|
"usage": "上传bpmn20的xml文件", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/definition/import", |
|
"operationId": "importFileUsingPOST", |
|
"parameters": [ |
|
{ |
|
"name": "name", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "name" |
|
}, |
|
{ |
|
"name": "category", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "category" |
|
} |
|
], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "string / binary" |
|
}, |
|
{ |
|
"contentType": "application/octet-stream", |
|
"schema": "string / binary" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "流程定义", |
|
"name": "流程定义列表", |
|
"usage": "", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/definition/list", |
|
"operationId": "listUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "pageNum", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "当前页码" |
|
}, |
|
{ |
|
"name": "pageSize", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "每页条数" |
|
}, |
|
{ |
|
"name": "name", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "流程名称" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "流程定义", |
|
"name": "读取图片文件", |
|
"usage": "", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/definition/readImage/{deployId}", |
|
"operationId": "readImageUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "deployId", |
|
"in": "path", |
|
"required": true, |
|
"type": "string", |
|
"description": "流程定义id" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "流程定义", |
|
"name": "读取xml文件", |
|
"usage": "", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/definition/readXml/{deployId}", |
|
"operationId": "readXmlUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "deployId", |
|
"in": "path", |
|
"required": true, |
|
"type": "string", |
|
"description": "流程定义id" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "流程定义", |
|
"name": "指定流程办理组列表", |
|
"usage": "", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/definition/roleList", |
|
"operationId": "roleListUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "admin", |
|
"in": "query", |
|
"required": false, |
|
"type": "boolean", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "createBy", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "createByName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "dataScope", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "delFlag", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "deptCheckStrictly", |
|
"in": "query", |
|
"required": false, |
|
"type": "boolean", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "deptIds", |
|
"in": "query", |
|
"required": false, |
|
"type": "array<integer / int64>", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "flag", |
|
"in": "query", |
|
"required": false, |
|
"type": "boolean", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "menuCheckStrictly", |
|
"in": "query", |
|
"required": false, |
|
"type": "boolean", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "menuIds", |
|
"in": "query", |
|
"required": false, |
|
"type": "array<integer / int64>", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "params", |
|
"in": "query", |
|
"required": false, |
|
"type": "object", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "permissions", |
|
"in": "query", |
|
"required": false, |
|
"type": "array<string>", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "remark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "roleId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "roleKey", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "roleName", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "roleSort", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "searchValue", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "status", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "updateBy", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "updateByName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "流程定义", |
|
"name": "保存流程设计器内的xml文件", |
|
"usage": "", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/definition/save", |
|
"operationId": "saveUsingPOST", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "FlowSaveXmlVo" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "流程定义", |
|
"name": "发起流程", |
|
"usage": "", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/definition/start/{procDefId}", |
|
"operationId": "startUsingPOST", |
|
"parameters": [ |
|
{ |
|
"name": "procDefId", |
|
"in": "path", |
|
"required": true, |
|
"type": "string", |
|
"description": "流程定义id" |
|
} |
|
], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "object" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "流程定义", |
|
"name": "激活或挂起流程定义", |
|
"usage": "", |
|
"method": "PUT", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/definition/updateState", |
|
"operationId": "updateStateUsingPUT", |
|
"parameters": [ |
|
{ |
|
"name": "state", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "1:激活,2:挂起" |
|
}, |
|
{ |
|
"name": "deployId", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "流程部署ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "流程定义", |
|
"name": "指定流程办理人员列表", |
|
"usage": "", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/definition/userList", |
|
"operationId": "userListUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "admin", |
|
"in": "query", |
|
"required": false, |
|
"type": "boolean", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "avatar", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "createBy", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "createByName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "delFlag", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "dept.ancestors", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "dept.createBy", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "dept.createByName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "dept.createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "dept.delFlag", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "dept.deptId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "dept.deptName", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "dept.email", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "dept.leader", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "dept.orderNum", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "dept.params", |
|
"in": "query", |
|
"required": false, |
|
"type": "object", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "dept.parentId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "dept.parentName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "dept.phone", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "dept.searchValue", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "dept.status", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "dept.updateBy", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "dept.updateByName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "dept.updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "deptId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "email", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "loginDate", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "loginIp", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "nickName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "params", |
|
"in": "query", |
|
"required": false, |
|
"type": "object", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "password", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "phonenumber", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "postIds", |
|
"in": "query", |
|
"required": false, |
|
"type": "array<integer / int64>", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "postNames", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "remark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "roleId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "roleIds", |
|
"in": "query", |
|
"required": false, |
|
"type": "array<string>", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "roles[0].admin", |
|
"in": "query", |
|
"required": false, |
|
"type": "boolean", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "roles[0].createBy", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "roles[0].createByName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "roles[0].createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "roles[0].dataScope", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "roles[0].delFlag", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "roles[0].deptCheckStrictly", |
|
"in": "query", |
|
"required": false, |
|
"type": "boolean", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "roles[0].deptIds", |
|
"in": "query", |
|
"required": false, |
|
"type": "array<integer / int64>", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "roles[0].flag", |
|
"in": "query", |
|
"required": false, |
|
"type": "boolean", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "roles[0].menuCheckStrictly", |
|
"in": "query", |
|
"required": false, |
|
"type": "boolean", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "roles[0].menuIds", |
|
"in": "query", |
|
"required": false, |
|
"type": "array<integer / int64>", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "roles[0].params", |
|
"in": "query", |
|
"required": false, |
|
"type": "object", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "roles[0].permissions", |
|
"in": "query", |
|
"required": false, |
|
"type": "array<string>", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "roles[0].remark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "roles[0].roleId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "roles[0].roleKey", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "roles[0].roleName", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "roles[0].roleSort", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "roles[0].searchValue", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "roles[0].status", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "roles[0].updateBy", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "roles[0].updateByName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "roles[0].updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "sapCode", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "searchValue", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "sex", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "status", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "updateBy", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "updateByName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "userId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "" |
|
}, |
|
{ |
|
"name": "userName", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "流程定义", |
|
"name": "删除流程", |
|
"usage": "", |
|
"method": "DELETE", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/definition/{deployIds}", |
|
"operationId": "deleteUsingDELETE", |
|
"parameters": [ |
|
{ |
|
"name": "deployIds", |
|
"in": "path", |
|
"required": true, |
|
"type": "string", |
|
"description": "deployIds" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "204", |
|
"description": "No Content", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "工作流流程实例管理", |
|
"name": "删除流程实例", |
|
"usage": "", |
|
"method": "DELETE", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/instance/delete/{instanceIds}", |
|
"operationId": "deleteUsingDELETE_1", |
|
"parameters": [ |
|
{ |
|
"name": "instanceIds", |
|
"in": "path", |
|
"required": true, |
|
"type": "string", |
|
"description": "流程实例ID" |
|
}, |
|
{ |
|
"name": "deleteReason", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "删除原因" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "204", |
|
"description": "No Content", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "工作流流程实例管理", |
|
"name": "根据流程定义id启动流程实例", |
|
"usage": "", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/instance/startBy/{procDefId}", |
|
"operationId": "startByIdUsingPOST", |
|
"parameters": [ |
|
{ |
|
"name": "procDefId", |
|
"in": "path", |
|
"required": true, |
|
"type": "string", |
|
"description": "流程定义id" |
|
} |
|
], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "object" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "工作流流程实例管理", |
|
"name": "结束流程实例", |
|
"usage": "", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/instance/stopProcessInstance", |
|
"operationId": "stopProcessInstanceUsingPOST", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "工作流任务相关--请求参数" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "工作流流程实例管理", |
|
"name": "激活或挂起流程实例", |
|
"usage": "", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/instance/updateState", |
|
"operationId": "updateStateUsingPOST", |
|
"parameters": [ |
|
{ |
|
"name": "state", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "1:激活,2:挂起" |
|
}, |
|
{ |
|
"name": "instanceId", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "流程实例ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "工作流流程任务管理", |
|
"name": "多实例加签", |
|
"usage": "", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/task/addMultiInstanceExecution", |
|
"operationId": "addMultiInstanceExecutionUsingPOST", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "工作流任务相关--请求参数" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "工作流流程任务管理", |
|
"name": "转办任务", |
|
"usage": "", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/task/assignTask", |
|
"operationId": "assignUsingPOST", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "工作流任务相关--请求参数" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "工作流流程任务管理", |
|
"name": "认领/签收任务", |
|
"usage": "", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/task/claim", |
|
"operationId": "claimUsingPOST", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "工作流任务相关--请求参数" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "工作流流程任务管理", |
|
"name": "审批任务", |
|
"usage": "", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/task/complete", |
|
"operationId": "completeUsingPOST_1", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "工作流任务相关--请求参数" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "工作流流程任务管理", |
|
"name": "委派任务", |
|
"usage": "", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/task/delegateTask", |
|
"operationId": "delegateUsingPOST", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "工作流任务相关--请求参数" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "工作流流程任务管理", |
|
"name": "删除任务", |
|
"usage": "", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/task/delete", |
|
"operationId": "deleteUsingPOST", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "工作流任务相关--请求参数" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "工作流流程任务管理", |
|
"name": "清空任务", |
|
"usage": "", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/task/deleteAll", |
|
"operationId": "deleteAllUsingGET", |
|
"parameters": [], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "工作流流程任务管理", |
|
"name": "多实例减签", |
|
"usage": "", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/task/deleteMultiInstanceExecution", |
|
"operationId": "deleteMultiInstanceExecutionUsingPOST", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "工作流任务相关--请求参数" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "工作流流程任务管理", |
|
"name": "获取已办任务", |
|
"usage": "", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/task/finishedList", |
|
"operationId": "finishedListUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "businessId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "业务id" |
|
}, |
|
{ |
|
"name": "businessType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "业务类型" |
|
}, |
|
{ |
|
"name": "endTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "结束时间" |
|
}, |
|
{ |
|
"name": "name", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "流程名称" |
|
}, |
|
{ |
|
"name": "pageNum", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "当前页码" |
|
}, |
|
{ |
|
"name": "pageSize", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "每页条数" |
|
}, |
|
{ |
|
"name": "procInsId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "流程编码" |
|
}, |
|
{ |
|
"name": "startTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "开始时间" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "工作流流程任务管理", |
|
"name": "流程初始化表单", |
|
"usage": "", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/task/flowFormData", |
|
"operationId": "flowFormDataUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "deployId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "deployId" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "工作流流程任务管理", |
|
"name": "流程历史流转记录", |
|
"usage": "", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/task/flowRecord", |
|
"operationId": "flowRecordUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "procInsId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "procInsId" |
|
}, |
|
{ |
|
"name": "deployId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "deployId" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "工作流流程任务管理", |
|
"name": "我发起的流程", |
|
"usage": "", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/task/myProcess", |
|
"operationId": "myProcessUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "businessId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "业务id" |
|
}, |
|
{ |
|
"name": "businessType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "业务类型" |
|
}, |
|
{ |
|
"name": "endTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "结束时间" |
|
}, |
|
{ |
|
"name": "name", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "流程名称" |
|
}, |
|
{ |
|
"name": "pageNum", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "当前页码" |
|
}, |
|
{ |
|
"name": "pageSize", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "每页条数" |
|
}, |
|
{ |
|
"name": "procInsId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "流程编码" |
|
}, |
|
{ |
|
"name": "startTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "开始时间" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "工作流流程任务管理", |
|
"name": "获取下一节点", |
|
"usage": "", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/task/nextFlowNode", |
|
"operationId": "getNextFlowNodeUsingPOST", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "工作流任务相关--请求参数" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "工作流流程任务管理", |
|
"name": "流程发起时获取下一节点", |
|
"usage": "", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/task/nextFlowNodeByStart", |
|
"operationId": "getNextFlowNodeByStartUsingPOST", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "工作流任务相关--请求参数" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "工作流流程任务管理", |
|
"name": "获取流程变量", |
|
"usage": "", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/task/processVariables/{taskId}", |
|
"operationId": "processVariablesUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "taskId", |
|
"in": "path", |
|
"required": true, |
|
"type": "string", |
|
"description": "流程任务Id" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "工作流流程任务管理", |
|
"name": "驳回任务", |
|
"usage": "", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/task/reject", |
|
"operationId": "taskRejectUsingPOST", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "工作流任务相关--请求参数" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "工作流流程任务管理", |
|
"name": "任务归还", |
|
"usage": "", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/task/resolveTask", |
|
"operationId": "resolveTaskUsingPOST", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "工作流任务相关--请求参数" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "工作流流程任务管理", |
|
"name": "退回任务", |
|
"usage": "", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/task/return", |
|
"operationId": "taskReturnUsingPOST", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "工作流任务相关--请求参数" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "工作流流程任务管理", |
|
"name": "获取所有可回退的节点", |
|
"usage": "", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/task/returnList", |
|
"operationId": "findReturnTaskListUsingPOST", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "工作流任务相关--请求参数" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "工作流流程任务管理", |
|
"name": "撤回流程", |
|
"usage": "", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/task/revokeProcess", |
|
"operationId": "revokeProcessUsingPOST", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "工作流任务相关--请求参数" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "工作流流程任务管理", |
|
"name": "取消申请", |
|
"usage": "", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/task/stopProcess", |
|
"operationId": "stopProcessUsingPOST", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "工作流任务相关--请求参数" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "工作流流程任务管理", |
|
"name": "获取待办列表", |
|
"usage": "", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/task/todoList", |
|
"operationId": "todoListUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "businessId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "业务id" |
|
}, |
|
{ |
|
"name": "businessType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "业务类型" |
|
}, |
|
{ |
|
"name": "endTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "结束时间" |
|
}, |
|
{ |
|
"name": "name", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "流程名称" |
|
}, |
|
{ |
|
"name": "pageNum", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "当前页码" |
|
}, |
|
{ |
|
"name": "pageSize", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "每页条数" |
|
}, |
|
{ |
|
"name": "procInsId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "流程编码" |
|
}, |
|
{ |
|
"name": "startTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "开始时间" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "工作流流程任务管理", |
|
"name": "取消认领/签收任务", |
|
"usage": "", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/task/unClaim", |
|
"operationId": "unClaimUsingPOST", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "工作流任务相关--请求参数" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "隐患上报流程", |
|
"name": "审批隐患流程", |
|
"usage": "审批通过或驳回,需携带taskId、comment、result等信息。成功返回 data 为 null;失败返回 error 信息。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/hazard/complete", |
|
"operationId": "completeUsingPOST_2", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "工作流签字任务相关--请求参数" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "隐患上报流程", |
|
"name": "隐患流程详情", |
|
"usage": "返回 data 为 HazardReport 对象,包含完整隐患字段及流程状态信息。主要字段:id、reportNo、hazardName、status-状态编码、flowStatus-流程状态、canApprove-是否可审批。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/hazard/detail/{id}", |
|
"operationId": "detailUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "path", |
|
"required": true, |
|
"type": "integer / int64", |
|
"description": "隐患ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "隐患上报流程", |
|
"name": "上报隐患并提交流程", |
|
"usage": "先调用uploadAttachment上传附件,再将report和attachments一起提交。成功返回 data 为流程实例ID字符串;失败返回 error 信息。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/hazard/submitFlow", |
|
"operationId": "submitFlowUsingPOST", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "隐患上报流程提交请求" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "隐患上报流程", |
|
"name": "切换隐患流程等级", |
|
"usage": "审批过程中重新评估隐患等级,作废当前流程并以新等级重新启动审批。等级编码:general-一般隐患 / major-较大隐患 / critical-重大隐患。返回新流程实例ID。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/hazard/switchLevel", |
|
"operationId": "switchLevelUsingPOST", |
|
"parameters": [ |
|
{ |
|
"name": "reportId", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int64", |
|
"description": "隐患记录ID" |
|
}, |
|
{ |
|
"name": "newHazardLevel", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "目标等级编码(general/major/critical)" |
|
}, |
|
{ |
|
"name": "switchReason", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "切换原因" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "隐患上报流程", |
|
"name": "隐患流程待办/已办列表", |
|
"usage": "返回 data 为 PageInfo 分页对象。list 中每条记录为 HazardReport 对象,包含 id、reportNo、hazardName、status、createTime 等字段。支持 pageNum、pageSize 等筛选参数。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/hazard/todoList", |
|
"operationId": "todoListUsingGET_1", |
|
"parameters": [ |
|
{ |
|
"name": "params", |
|
"in": "query", |
|
"required": true, |
|
"type": "object<string, string>", |
|
"description": "查询参数(支持pageNum/pageSize等)" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "隐患信息管理", |
|
"name": "新增", |
|
"usage": "新增单条记录,请求体为实体类对象(字段说明见对应实体模型)。成功返回 data 为 null。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/hazard/add", |
|
"operationId": "addOneUsingPOST_8", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "隐患信息" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "隐患信息管理", |
|
"name": "批量新增", |
|
"usage": "批量新增多条记录,请求体为实体类数组。成功返回 data 为 null。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/hazard/addBatch", |
|
"operationId": "addBatchUsingPOST_8", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "array<隐患信息>" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "隐患信息管理", |
|
"name": "新增并返回保存的数据", |
|
"usage": "新增单条记录并返回保存后的数据(含自增ID),请求体为实体类对象。成功返回 data 为保存的实体对象。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/hazard/addReturn", |
|
"operationId": "addReturnUsingPOST_8", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "隐患信息" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "隐患信息管理", |
|
"name": "删除附件", |
|
"usage": "返回 data 为 boolean,true-删除成功。", |
|
"method": "DELETE", |
|
"path": "/gd_dataserver/gd_dataserver/business/hazard/attachment/{ids}", |
|
"operationId": "removeAttachmentUsingDELETE", |
|
"parameters": [ |
|
{ |
|
"name": "ids", |
|
"in": "path", |
|
"required": true, |
|
"type": "string", |
|
"description": "附件ID列表(逗号分隔)" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "204", |
|
"description": "No Content", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "隐患信息管理", |
|
"name": "按隐患ID查附件列表", |
|
"usage": "返回 data 为 HazardAttachment 数组。每个元素包含:id-附件ID、reportId-隐患ID、fileName-文件名、fileUrl-文件访问URL、fileType-文件类型、fileSize-文件大小。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/hazard/attachment/{reportId}", |
|
"operationId": "listAttachmentsUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "reportId", |
|
"in": "path", |
|
"required": true, |
|
"type": "integer / int64", |
|
"description": "隐患ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "隐患信息管理", |
|
"name": "根据属性删除", |
|
"usage": "根据实体属性条件删除记录,请求体为实体类对象。成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/hazard/delete", |
|
"operationId": "deleteUsingGET_8", |
|
"parameters": [ |
|
{ |
|
"name": "actualCompleteTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "实际完成时间" |
|
}, |
|
{ |
|
"name": "attachments[0].attachmentType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "附件类型:IMAGE-图片 VIDEO-视频 DOCUMENT-文档 OTHER-其他" |
|
}, |
|
{ |
|
"name": "attachments[0].createBy", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "创建者" |
|
}, |
|
{ |
|
"name": "attachments[0].createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "attachments[0].fileName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "文件原始名称" |
|
}, |
|
{ |
|
"name": "attachments[0].filePath", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "文件存储路径" |
|
}, |
|
{ |
|
"name": "attachments[0].fileSize", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "文件大小(字节)" |
|
}, |
|
{ |
|
"name": "attachments[0].fileType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "文件MIME类型" |
|
}, |
|
{ |
|
"name": "attachments[0].id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "attachments[0].remark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "备注" |
|
}, |
|
{ |
|
"name": "attachments[0].reportId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "关联隐患ID" |
|
}, |
|
{ |
|
"name": "attachments[0].sortOrder", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "排序" |
|
}, |
|
{ |
|
"name": "attachments[0].suffix", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "文件后缀" |
|
}, |
|
{ |
|
"name": "attachments[0].updateBy", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "更新者" |
|
}, |
|
{ |
|
"name": "attachments[0].updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "更新时间" |
|
}, |
|
{ |
|
"name": "attachments[0].uploadUserId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "上传人用户ID" |
|
}, |
|
{ |
|
"name": "auditRemark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "审核备注" |
|
}, |
|
{ |
|
"name": "auditTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "审核时间" |
|
}, |
|
{ |
|
"name": "auditUserId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "审核人用户ID" |
|
}, |
|
{ |
|
"name": "auditUserName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "审核人姓名" |
|
}, |
|
{ |
|
"name": "auditUserUsername", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "审核人账号" |
|
}, |
|
{ |
|
"name": "canApprove", |
|
"in": "query", |
|
"required": false, |
|
"type": "boolean", |
|
"description": "当前用户是否可审批此流程" |
|
}, |
|
{ |
|
"name": "causeAnalysis", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "原因分析" |
|
}, |
|
{ |
|
"name": "chargePersonId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "整改负责人用户ID" |
|
}, |
|
{ |
|
"name": "chargePersonName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "整改负责人姓名" |
|
}, |
|
{ |
|
"name": "chargePersonUsername", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "整改负责人账号" |
|
}, |
|
{ |
|
"name": "createBy", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "创建者" |
|
}, |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "criteriaIds", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "判定标准ID(多选,逗号分隔)" |
|
}, |
|
{ |
|
"name": "criteriaNames", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "判定标准名称" |
|
}, |
|
{ |
|
"name": "currentFlowLevel", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "当前流程等级编码(general/major/critical)" |
|
}, |
|
{ |
|
"name": "departmentId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "部门ID" |
|
}, |
|
{ |
|
"name": "departmentName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "部门名称" |
|
}, |
|
{ |
|
"name": "deployId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "流程模板id" |
|
}, |
|
{ |
|
"name": "description", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患描述" |
|
}, |
|
{ |
|
"name": "discoverTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "发现时间" |
|
}, |
|
{ |
|
"name": "factoryDeptId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "所属厂区部门ID" |
|
}, |
|
{ |
|
"name": "factoryDeptName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "所属厂区部门名称" |
|
}, |
|
{ |
|
"name": "finalFlowLevel", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "审批最终等级名称(如一般-A档)" |
|
}, |
|
{ |
|
"name": "finalFlowLevelId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "审批最终积分规则ID(关联积分规则表)" |
|
}, |
|
{ |
|
"name": "flowInstanceId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "流程实例id" |
|
}, |
|
{ |
|
"name": "flowStatus", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "流程状态(0-未开始 1-进行中 2-已完成)" |
|
}, |
|
{ |
|
"name": "fundsSource", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "资金来源编码" |
|
}, |
|
{ |
|
"name": "fundsSourceId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "资金来源字典ID" |
|
}, |
|
{ |
|
"name": "fundsSourceName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "资金来源名称" |
|
}, |
|
{ |
|
"name": "governanceType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "治理类型编码" |
|
}, |
|
{ |
|
"name": "governanceTypeId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "治理类型字典ID" |
|
}, |
|
{ |
|
"name": "governanceTypeName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "治理类型名称" |
|
}, |
|
{ |
|
"name": "hazardCategory", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患分类编码(general/major/critical)" |
|
}, |
|
{ |
|
"name": "hazardCategoryId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "隐患分类根规则ID(关联积分规则表)" |
|
}, |
|
{ |
|
"name": "hazardCategoryName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患分类名称" |
|
}, |
|
{ |
|
"name": "hazardLevel", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "管理级别编码" |
|
}, |
|
{ |
|
"name": "hazardLevelId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "管理级别字典ID" |
|
}, |
|
{ |
|
"name": "hazardLevelName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "管理级别名称" |
|
}, |
|
{ |
|
"name": "hazardName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患名称" |
|
}, |
|
{ |
|
"name": "hazardSourceDetail", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "来源具体描述" |
|
}, |
|
{ |
|
"name": "hazardType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患类型编码" |
|
}, |
|
{ |
|
"name": "hazardTypeId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "隐患类型字典ID" |
|
}, |
|
{ |
|
"name": "hazardTypeName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患类型名称" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "isInitiator", |
|
"in": "query", |
|
"required": false, |
|
"type": "boolean", |
|
"description": "当前用户是否为此流程发起人" |
|
}, |
|
{ |
|
"name": "limitedCompleteTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "限定完成时间" |
|
}, |
|
{ |
|
"name": "major", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "专业编码" |
|
}, |
|
{ |
|
"name": "majorId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "专业字典ID" |
|
}, |
|
{ |
|
"name": "majorName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "专业名称" |
|
}, |
|
{ |
|
"name": "pointsAwarded", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "奖励积分" |
|
}, |
|
{ |
|
"name": "pointsStatus", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "积分发放状态编码" |
|
}, |
|
{ |
|
"name": "pointsStatusId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "积分发放状态字典ID" |
|
}, |
|
{ |
|
"name": "pointsStatusName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "积分发放状态名称" |
|
}, |
|
{ |
|
"name": "preventiveMeasures", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "防范措施" |
|
}, |
|
{ |
|
"name": "pushResponse", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "第三方返回结果" |
|
}, |
|
{ |
|
"name": "pushStatus", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "推送状态编码" |
|
}, |
|
{ |
|
"name": "pushStatusId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "推送状态字典ID" |
|
}, |
|
{ |
|
"name": "pushStatusName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "推送状态名称" |
|
}, |
|
{ |
|
"name": "pushTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "推送时间" |
|
}, |
|
{ |
|
"name": "rectificationPlan", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "整改方案" |
|
}, |
|
{ |
|
"name": "remark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "备注" |
|
}, |
|
{ |
|
"name": "reportNo", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患编号" |
|
}, |
|
{ |
|
"name": "reporterId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "上报人用户ID" |
|
}, |
|
{ |
|
"name": "reporterName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "上报人姓名" |
|
}, |
|
{ |
|
"name": "reporterUsername", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "上报人账号" |
|
}, |
|
{ |
|
"name": "riskTarget", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "风险分析对象" |
|
}, |
|
{ |
|
"name": "riskUnit", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "风险分析单元" |
|
}, |
|
{ |
|
"name": "sourceType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患来源编码" |
|
}, |
|
{ |
|
"name": "sourceTypeId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "隐患来源字典ID" |
|
}, |
|
{ |
|
"name": "sourceTypeName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患来源名称" |
|
}, |
|
{ |
|
"name": "status", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患状态编码" |
|
}, |
|
{ |
|
"name": "statusId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "隐患状态字典ID" |
|
}, |
|
{ |
|
"name": "statusName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患状态名称" |
|
}, |
|
{ |
|
"name": "supervisorId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "监察人用户ID" |
|
}, |
|
{ |
|
"name": "supervisorName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "监察人姓名" |
|
}, |
|
{ |
|
"name": "supervisorUsername", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "监察人账号" |
|
}, |
|
{ |
|
"name": "thirdPartyId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "第三方系统记录ID" |
|
}, |
|
{ |
|
"name": "unitId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "单位ID" |
|
}, |
|
{ |
|
"name": "unitName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "单位名称" |
|
}, |
|
{ |
|
"name": "updateBy", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "更新者" |
|
}, |
|
{ |
|
"name": "updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "更新时间" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "隐患信息管理", |
|
"name": "主键删除", |
|
"usage": "根据主键ID删除单条记录,成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/hazard/deleteById", |
|
"operationId": "deleteOneUsingGET_8", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "主键ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "隐患信息管理", |
|
"name": "批量删除", |
|
"usage": "根据ID列表批量删除记录,成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/hazard/deleteByIds", |
|
"operationId": "deleteListUsingGET_17", |
|
"parameters": [ |
|
{ |
|
"name": "ids", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "ID列表(逗号分隔)" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "隐患信息管理", |
|
"name": "导出隐患列表Excel", |
|
"usage": "直接返回 Excel 文件流(Content-Type: application/octet-stream),前端需以 Blob 方式接收并下载。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/hazard/export", |
|
"operationId": "exportUsingPOST", |
|
"parameters": [ |
|
{ |
|
"name": "actualCompleteTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "实际完成时间" |
|
}, |
|
{ |
|
"name": "attachments[0].attachmentType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "附件类型:IMAGE-图片 VIDEO-视频 DOCUMENT-文档 OTHER-其他" |
|
}, |
|
{ |
|
"name": "attachments[0].createBy", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "创建者" |
|
}, |
|
{ |
|
"name": "attachments[0].createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "attachments[0].fileName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "文件原始名称" |
|
}, |
|
{ |
|
"name": "attachments[0].filePath", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "文件存储路径" |
|
}, |
|
{ |
|
"name": "attachments[0].fileSize", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "文件大小(字节)" |
|
}, |
|
{ |
|
"name": "attachments[0].fileType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "文件MIME类型" |
|
}, |
|
{ |
|
"name": "attachments[0].id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "attachments[0].remark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "备注" |
|
}, |
|
{ |
|
"name": "attachments[0].reportId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "关联隐患ID" |
|
}, |
|
{ |
|
"name": "attachments[0].sortOrder", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "排序" |
|
}, |
|
{ |
|
"name": "attachments[0].suffix", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "文件后缀" |
|
}, |
|
{ |
|
"name": "attachments[0].updateBy", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "更新者" |
|
}, |
|
{ |
|
"name": "attachments[0].updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "更新时间" |
|
}, |
|
{ |
|
"name": "attachments[0].uploadUserId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "上传人用户ID" |
|
}, |
|
{ |
|
"name": "auditRemark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "审核备注" |
|
}, |
|
{ |
|
"name": "auditTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "审核时间" |
|
}, |
|
{ |
|
"name": "auditUserId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "审核人用户ID" |
|
}, |
|
{ |
|
"name": "auditUserName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "审核人姓名" |
|
}, |
|
{ |
|
"name": "auditUserUsername", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "审核人账号" |
|
}, |
|
{ |
|
"name": "canApprove", |
|
"in": "query", |
|
"required": false, |
|
"type": "boolean", |
|
"description": "当前用户是否可审批此流程" |
|
}, |
|
{ |
|
"name": "causeAnalysis", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "原因分析" |
|
}, |
|
{ |
|
"name": "chargePersonId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "整改负责人用户ID" |
|
}, |
|
{ |
|
"name": "chargePersonName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "整改负责人姓名" |
|
}, |
|
{ |
|
"name": "chargePersonUsername", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "整改负责人账号" |
|
}, |
|
{ |
|
"name": "createBy", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "创建者" |
|
}, |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "criteriaIds", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "判定标准ID(多选,逗号分隔)" |
|
}, |
|
{ |
|
"name": "criteriaNames", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "判定标准名称" |
|
}, |
|
{ |
|
"name": "currentFlowLevel", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "当前流程等级编码(general/major/critical)" |
|
}, |
|
{ |
|
"name": "departmentId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "部门ID" |
|
}, |
|
{ |
|
"name": "departmentName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "部门名称" |
|
}, |
|
{ |
|
"name": "deployId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "流程模板id" |
|
}, |
|
{ |
|
"name": "description", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患描述" |
|
}, |
|
{ |
|
"name": "discoverTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "发现时间" |
|
}, |
|
{ |
|
"name": "factoryDeptId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "所属厂区部门ID" |
|
}, |
|
{ |
|
"name": "factoryDeptName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "所属厂区部门名称" |
|
}, |
|
{ |
|
"name": "finalFlowLevel", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "审批最终等级名称(如一般-A档)" |
|
}, |
|
{ |
|
"name": "finalFlowLevelId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "审批最终积分规则ID(关联积分规则表)" |
|
}, |
|
{ |
|
"name": "flowInstanceId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "流程实例id" |
|
}, |
|
{ |
|
"name": "flowStatus", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "流程状态(0-未开始 1-进行中 2-已完成)" |
|
}, |
|
{ |
|
"name": "fundsSource", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "资金来源编码" |
|
}, |
|
{ |
|
"name": "fundsSourceId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "资金来源字典ID" |
|
}, |
|
{ |
|
"name": "fundsSourceName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "资金来源名称" |
|
}, |
|
{ |
|
"name": "governanceType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "治理类型编码" |
|
}, |
|
{ |
|
"name": "governanceTypeId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "治理类型字典ID" |
|
}, |
|
{ |
|
"name": "governanceTypeName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "治理类型名称" |
|
}, |
|
{ |
|
"name": "hazardCategory", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患分类编码(general/major/critical)" |
|
}, |
|
{ |
|
"name": "hazardCategoryId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "隐患分类根规则ID(关联积分规则表)" |
|
}, |
|
{ |
|
"name": "hazardCategoryName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患分类名称" |
|
}, |
|
{ |
|
"name": "hazardLevel", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "管理级别编码" |
|
}, |
|
{ |
|
"name": "hazardLevelId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "管理级别字典ID" |
|
}, |
|
{ |
|
"name": "hazardLevelName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "管理级别名称" |
|
}, |
|
{ |
|
"name": "hazardName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患名称" |
|
}, |
|
{ |
|
"name": "hazardSourceDetail", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "来源具体描述" |
|
}, |
|
{ |
|
"name": "hazardType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患类型编码" |
|
}, |
|
{ |
|
"name": "hazardTypeId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "隐患类型字典ID" |
|
}, |
|
{ |
|
"name": "hazardTypeName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患类型名称" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "isInitiator", |
|
"in": "query", |
|
"required": false, |
|
"type": "boolean", |
|
"description": "当前用户是否为此流程发起人" |
|
}, |
|
{ |
|
"name": "limitedCompleteTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "限定完成时间" |
|
}, |
|
{ |
|
"name": "major", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "专业编码" |
|
}, |
|
{ |
|
"name": "majorId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "专业字典ID" |
|
}, |
|
{ |
|
"name": "majorName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "专业名称" |
|
}, |
|
{ |
|
"name": "pointsAwarded", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "奖励积分" |
|
}, |
|
{ |
|
"name": "pointsStatus", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "积分发放状态编码" |
|
}, |
|
{ |
|
"name": "pointsStatusId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "积分发放状态字典ID" |
|
}, |
|
{ |
|
"name": "pointsStatusName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "积分发放状态名称" |
|
}, |
|
{ |
|
"name": "preventiveMeasures", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "防范措施" |
|
}, |
|
{ |
|
"name": "pushResponse", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "第三方返回结果" |
|
}, |
|
{ |
|
"name": "pushStatus", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "推送状态编码" |
|
}, |
|
{ |
|
"name": "pushStatusId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "推送状态字典ID" |
|
}, |
|
{ |
|
"name": "pushStatusName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "推送状态名称" |
|
}, |
|
{ |
|
"name": "pushTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "推送时间" |
|
}, |
|
{ |
|
"name": "rectificationPlan", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "整改方案" |
|
}, |
|
{ |
|
"name": "remark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "备注" |
|
}, |
|
{ |
|
"name": "reportNo", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患编号" |
|
}, |
|
{ |
|
"name": "reporterId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "上报人用户ID" |
|
}, |
|
{ |
|
"name": "reporterName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "上报人姓名" |
|
}, |
|
{ |
|
"name": "reporterUsername", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "上报人账号" |
|
}, |
|
{ |
|
"name": "riskTarget", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "风险分析对象" |
|
}, |
|
{ |
|
"name": "riskUnit", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "风险分析单元" |
|
}, |
|
{ |
|
"name": "sourceType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患来源编码" |
|
}, |
|
{ |
|
"name": "sourceTypeId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "隐患来源字典ID" |
|
}, |
|
{ |
|
"name": "sourceTypeName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患来源名称" |
|
}, |
|
{ |
|
"name": "status", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患状态编码" |
|
}, |
|
{ |
|
"name": "statusId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "隐患状态字典ID" |
|
}, |
|
{ |
|
"name": "statusName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患状态名称" |
|
}, |
|
{ |
|
"name": "supervisorId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "监察人用户ID" |
|
}, |
|
{ |
|
"name": "supervisorName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "监察人姓名" |
|
}, |
|
{ |
|
"name": "supervisorUsername", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "监察人账号" |
|
}, |
|
{ |
|
"name": "thirdPartyId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "第三方系统记录ID" |
|
}, |
|
{ |
|
"name": "unitId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "单位ID" |
|
}, |
|
{ |
|
"name": "unitName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "单位名称" |
|
}, |
|
{ |
|
"name": "updateBy", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "更新者" |
|
}, |
|
{ |
|
"name": "updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "更新时间" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "隐患信息管理", |
|
"name": "生成隐患编号", |
|
"usage": "返回 data 为 String 类型的隐患编号,格式如 HR20260827001。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/hazard/generateReportNo", |
|
"operationId": "generateReportNoUsingPOST", |
|
"parameters": [], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "隐患信息管理", |
|
"name": "查询所有", |
|
"usage": "查询所有记录(无分页、无条件)。成功返回 data 为实体类数组。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/hazard/getAll", |
|
"operationId": "getAllUsingGET_8", |
|
"parameters": [], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "隐患信息管理", |
|
"name": "分页查询", |
|
"usage": "分页查询记录列表,查询条件为实体类字段。成功返回 data 为 PageInfo 分页对象,其中 list 为实体类数组。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/hazard/getListByPage", |
|
"operationId": "getListByPageUsingGET_8", |
|
"parameters": [ |
|
{ |
|
"name": "actualCompleteTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "实际完成时间" |
|
}, |
|
{ |
|
"name": "attachments[0].attachmentType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "附件类型:IMAGE-图片 VIDEO-视频 DOCUMENT-文档 OTHER-其他" |
|
}, |
|
{ |
|
"name": "attachments[0].createBy", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "创建者" |
|
}, |
|
{ |
|
"name": "attachments[0].createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "attachments[0].fileName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "文件原始名称" |
|
}, |
|
{ |
|
"name": "attachments[0].filePath", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "文件存储路径" |
|
}, |
|
{ |
|
"name": "attachments[0].fileSize", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "文件大小(字节)" |
|
}, |
|
{ |
|
"name": "attachments[0].fileType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "文件MIME类型" |
|
}, |
|
{ |
|
"name": "attachments[0].id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "attachments[0].remark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "备注" |
|
}, |
|
{ |
|
"name": "attachments[0].reportId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "关联隐患ID" |
|
}, |
|
{ |
|
"name": "attachments[0].sortOrder", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "排序" |
|
}, |
|
{ |
|
"name": "attachments[0].suffix", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "文件后缀" |
|
}, |
|
{ |
|
"name": "attachments[0].updateBy", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "更新者" |
|
}, |
|
{ |
|
"name": "attachments[0].updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "更新时间" |
|
}, |
|
{ |
|
"name": "attachments[0].uploadUserId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "上传人用户ID" |
|
}, |
|
{ |
|
"name": "auditRemark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "审核备注" |
|
}, |
|
{ |
|
"name": "auditTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "审核时间" |
|
}, |
|
{ |
|
"name": "auditUserId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "审核人用户ID" |
|
}, |
|
{ |
|
"name": "auditUserName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "审核人姓名" |
|
}, |
|
{ |
|
"name": "auditUserUsername", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "审核人账号" |
|
}, |
|
{ |
|
"name": "canApprove", |
|
"in": "query", |
|
"required": false, |
|
"type": "boolean", |
|
"description": "当前用户是否可审批此流程" |
|
}, |
|
{ |
|
"name": "causeAnalysis", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "原因分析" |
|
}, |
|
{ |
|
"name": "chargePersonId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "整改负责人用户ID" |
|
}, |
|
{ |
|
"name": "chargePersonName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "整改负责人姓名" |
|
}, |
|
{ |
|
"name": "chargePersonUsername", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "整改负责人账号" |
|
}, |
|
{ |
|
"name": "createBy", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "创建者" |
|
}, |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "criteriaIds", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "判定标准ID(多选,逗号分隔)" |
|
}, |
|
{ |
|
"name": "criteriaNames", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "判定标准名称" |
|
}, |
|
{ |
|
"name": "currentFlowLevel", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "当前流程等级编码(general/major/critical)" |
|
}, |
|
{ |
|
"name": "departmentId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "部门ID" |
|
}, |
|
{ |
|
"name": "departmentName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "部门名称" |
|
}, |
|
{ |
|
"name": "deployId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "流程模板id" |
|
}, |
|
{ |
|
"name": "description", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患描述" |
|
}, |
|
{ |
|
"name": "discoverTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "发现时间" |
|
}, |
|
{ |
|
"name": "factoryDeptId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "所属厂区部门ID" |
|
}, |
|
{ |
|
"name": "factoryDeptName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "所属厂区部门名称" |
|
}, |
|
{ |
|
"name": "finalFlowLevel", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "审批最终等级名称(如一般-A档)" |
|
}, |
|
{ |
|
"name": "finalFlowLevelId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "审批最终积分规则ID(关联积分规则表)" |
|
}, |
|
{ |
|
"name": "flowInstanceId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "流程实例id" |
|
}, |
|
{ |
|
"name": "flowStatus", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "流程状态(0-未开始 1-进行中 2-已完成)" |
|
}, |
|
{ |
|
"name": "fundsSource", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "资金来源编码" |
|
}, |
|
{ |
|
"name": "fundsSourceId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "资金来源字典ID" |
|
}, |
|
{ |
|
"name": "fundsSourceName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "资金来源名称" |
|
}, |
|
{ |
|
"name": "governanceType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "治理类型编码" |
|
}, |
|
{ |
|
"name": "governanceTypeId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "治理类型字典ID" |
|
}, |
|
{ |
|
"name": "governanceTypeName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "治理类型名称" |
|
}, |
|
{ |
|
"name": "hazardCategory", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患分类编码(general/major/critical)" |
|
}, |
|
{ |
|
"name": "hazardCategoryId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "隐患分类根规则ID(关联积分规则表)" |
|
}, |
|
{ |
|
"name": "hazardCategoryName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患分类名称" |
|
}, |
|
{ |
|
"name": "hazardLevel", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "管理级别编码" |
|
}, |
|
{ |
|
"name": "hazardLevelId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "管理级别字典ID" |
|
}, |
|
{ |
|
"name": "hazardLevelName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "管理级别名称" |
|
}, |
|
{ |
|
"name": "hazardName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患名称" |
|
}, |
|
{ |
|
"name": "hazardSourceDetail", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "来源具体描述" |
|
}, |
|
{ |
|
"name": "hazardType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患类型编码" |
|
}, |
|
{ |
|
"name": "hazardTypeId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "隐患类型字典ID" |
|
}, |
|
{ |
|
"name": "hazardTypeName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患类型名称" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "isInitiator", |
|
"in": "query", |
|
"required": false, |
|
"type": "boolean", |
|
"description": "当前用户是否为此流程发起人" |
|
}, |
|
{ |
|
"name": "limitedCompleteTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "限定完成时间" |
|
}, |
|
{ |
|
"name": "major", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "专业编码" |
|
}, |
|
{ |
|
"name": "majorId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "专业字典ID" |
|
}, |
|
{ |
|
"name": "majorName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "专业名称" |
|
}, |
|
{ |
|
"name": "pageNum", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "页码" |
|
}, |
|
{ |
|
"name": "pointsAwarded", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "奖励积分" |
|
}, |
|
{ |
|
"name": "pointsStatus", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "积分发放状态编码" |
|
}, |
|
{ |
|
"name": "pointsStatusId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "积分发放状态字典ID" |
|
}, |
|
{ |
|
"name": "pointsStatusName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "积分发放状态名称" |
|
}, |
|
{ |
|
"name": "preventiveMeasures", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "防范措施" |
|
}, |
|
{ |
|
"name": "pushResponse", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "第三方返回结果" |
|
}, |
|
{ |
|
"name": "pushStatus", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "推送状态编码" |
|
}, |
|
{ |
|
"name": "pushStatusId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "推送状态字典ID" |
|
}, |
|
{ |
|
"name": "pushStatusName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "推送状态名称" |
|
}, |
|
{ |
|
"name": "pushTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "推送时间" |
|
}, |
|
{ |
|
"name": "rectificationPlan", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "整改方案" |
|
}, |
|
{ |
|
"name": "remark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "备注" |
|
}, |
|
{ |
|
"name": "reportNo", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患编号" |
|
}, |
|
{ |
|
"name": "reporterId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "上报人用户ID" |
|
}, |
|
{ |
|
"name": "reporterName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "上报人姓名" |
|
}, |
|
{ |
|
"name": "reporterUsername", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "上报人账号" |
|
}, |
|
{ |
|
"name": "riskTarget", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "风险分析对象" |
|
}, |
|
{ |
|
"name": "riskUnit", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "风险分析单元" |
|
}, |
|
{ |
|
"name": "sourceType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患来源编码" |
|
}, |
|
{ |
|
"name": "sourceTypeId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "隐患来源字典ID" |
|
}, |
|
{ |
|
"name": "sourceTypeName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患来源名称" |
|
}, |
|
{ |
|
"name": "status", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患状态编码" |
|
}, |
|
{ |
|
"name": "statusId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "隐患状态字典ID" |
|
}, |
|
{ |
|
"name": "statusName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患状态名称" |
|
}, |
|
{ |
|
"name": "supervisorId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "监察人用户ID" |
|
}, |
|
{ |
|
"name": "supervisorName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "监察人姓名" |
|
}, |
|
{ |
|
"name": "supervisorUsername", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "监察人账号" |
|
}, |
|
{ |
|
"name": "thirdPartyId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "第三方系统记录ID" |
|
}, |
|
{ |
|
"name": "unitId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "单位ID" |
|
}, |
|
{ |
|
"name": "unitName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "单位名称" |
|
}, |
|
{ |
|
"name": "updateBy", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "更新者" |
|
}, |
|
{ |
|
"name": "updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "更新时间" |
|
}, |
|
{ |
|
"name": "pageSize", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "每页条数" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "隐患信息管理", |
|
"name": "详情", |
|
"usage": "根据主键ID查询单条记录详情。成功返回 data 为实体类对象,包含该实体所有字段。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/hazard/info", |
|
"operationId": "infoUsingGET_8", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "主键ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "隐患信息管理", |
|
"name": "查隐患详情", |
|
"usage": "返回 data 为 HazardReport 对象。主要字段:id-主键、reportNo-隐患编号、hazardName-隐患名称、description-隐患描述、unitName-单位名称、departmentName-部门名称、hazardLevelName-隐患级别名称、hazardCategoryName-隐患分类名称、status-状态编码(0待提交/1审核中/2整改中/3已通过/4已驳回)、statusName-状态名称、reporterName-上报人姓名、chargePersonName-整改负责人姓名、pointsAwarded-奖励积分、flowStatus-流程状态(0未开始/1进行中/2已完成)、canApprove-当前用户是否可审批、isInitiator-当前用户是否为此流程发起人。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/hazard/info/{id}", |
|
"operationId": "getInfoUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "path", |
|
"required": true, |
|
"type": "integer / int64", |
|
"description": "隐患ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "隐患信息管理", |
|
"name": "条件查询", |
|
"usage": "根据实体属性条件查询记录列表。成功返回 data 为实体类数组。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/hazard/list", |
|
"operationId": "getListUsingGET_8", |
|
"parameters": [ |
|
{ |
|
"name": "actualCompleteTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "实际完成时间" |
|
}, |
|
{ |
|
"name": "attachments[0].attachmentType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "附件类型:IMAGE-图片 VIDEO-视频 DOCUMENT-文档 OTHER-其他" |
|
}, |
|
{ |
|
"name": "attachments[0].createBy", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "创建者" |
|
}, |
|
{ |
|
"name": "attachments[0].createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "attachments[0].fileName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "文件原始名称" |
|
}, |
|
{ |
|
"name": "attachments[0].filePath", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "文件存储路径" |
|
}, |
|
{ |
|
"name": "attachments[0].fileSize", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "文件大小(字节)" |
|
}, |
|
{ |
|
"name": "attachments[0].fileType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "文件MIME类型" |
|
}, |
|
{ |
|
"name": "attachments[0].id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "attachments[0].remark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "备注" |
|
}, |
|
{ |
|
"name": "attachments[0].reportId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "关联隐患ID" |
|
}, |
|
{ |
|
"name": "attachments[0].sortOrder", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "排序" |
|
}, |
|
{ |
|
"name": "attachments[0].suffix", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "文件后缀" |
|
}, |
|
{ |
|
"name": "attachments[0].updateBy", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "更新者" |
|
}, |
|
{ |
|
"name": "attachments[0].updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "更新时间" |
|
}, |
|
{ |
|
"name": "attachments[0].uploadUserId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "上传人用户ID" |
|
}, |
|
{ |
|
"name": "auditRemark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "审核备注" |
|
}, |
|
{ |
|
"name": "auditTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "审核时间" |
|
}, |
|
{ |
|
"name": "auditUserId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "审核人用户ID" |
|
}, |
|
{ |
|
"name": "auditUserName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "审核人姓名" |
|
}, |
|
{ |
|
"name": "auditUserUsername", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "审核人账号" |
|
}, |
|
{ |
|
"name": "canApprove", |
|
"in": "query", |
|
"required": false, |
|
"type": "boolean", |
|
"description": "当前用户是否可审批此流程" |
|
}, |
|
{ |
|
"name": "causeAnalysis", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "原因分析" |
|
}, |
|
{ |
|
"name": "chargePersonId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "整改负责人用户ID" |
|
}, |
|
{ |
|
"name": "chargePersonName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "整改负责人姓名" |
|
}, |
|
{ |
|
"name": "chargePersonUsername", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "整改负责人账号" |
|
}, |
|
{ |
|
"name": "createBy", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "创建者" |
|
}, |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "criteriaIds", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "判定标准ID(多选,逗号分隔)" |
|
}, |
|
{ |
|
"name": "criteriaNames", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "判定标准名称" |
|
}, |
|
{ |
|
"name": "currentFlowLevel", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "当前流程等级编码(general/major/critical)" |
|
}, |
|
{ |
|
"name": "departmentId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "部门ID" |
|
}, |
|
{ |
|
"name": "departmentName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "部门名称" |
|
}, |
|
{ |
|
"name": "deployId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "流程模板id" |
|
}, |
|
{ |
|
"name": "description", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患描述" |
|
}, |
|
{ |
|
"name": "discoverTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "发现时间" |
|
}, |
|
{ |
|
"name": "factoryDeptId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "所属厂区部门ID" |
|
}, |
|
{ |
|
"name": "factoryDeptName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "所属厂区部门名称" |
|
}, |
|
{ |
|
"name": "finalFlowLevel", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "审批最终等级名称(如一般-A档)" |
|
}, |
|
{ |
|
"name": "finalFlowLevelId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "审批最终积分规则ID(关联积分规则表)" |
|
}, |
|
{ |
|
"name": "flowInstanceId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "流程实例id" |
|
}, |
|
{ |
|
"name": "flowStatus", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "流程状态(0-未开始 1-进行中 2-已完成)" |
|
}, |
|
{ |
|
"name": "fundsSource", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "资金来源编码" |
|
}, |
|
{ |
|
"name": "fundsSourceId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "资金来源字典ID" |
|
}, |
|
{ |
|
"name": "fundsSourceName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "资金来源名称" |
|
}, |
|
{ |
|
"name": "governanceType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "治理类型编码" |
|
}, |
|
{ |
|
"name": "governanceTypeId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "治理类型字典ID" |
|
}, |
|
{ |
|
"name": "governanceTypeName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "治理类型名称" |
|
}, |
|
{ |
|
"name": "hazardCategory", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患分类编码(general/major/critical)" |
|
}, |
|
{ |
|
"name": "hazardCategoryId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "隐患分类根规则ID(关联积分规则表)" |
|
}, |
|
{ |
|
"name": "hazardCategoryName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患分类名称" |
|
}, |
|
{ |
|
"name": "hazardLevel", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "管理级别编码" |
|
}, |
|
{ |
|
"name": "hazardLevelId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "管理级别字典ID" |
|
}, |
|
{ |
|
"name": "hazardLevelName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "管理级别名称" |
|
}, |
|
{ |
|
"name": "hazardName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患名称" |
|
}, |
|
{ |
|
"name": "hazardSourceDetail", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "来源具体描述" |
|
}, |
|
{ |
|
"name": "hazardType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患类型编码" |
|
}, |
|
{ |
|
"name": "hazardTypeId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "隐患类型字典ID" |
|
}, |
|
{ |
|
"name": "hazardTypeName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患类型名称" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "isInitiator", |
|
"in": "query", |
|
"required": false, |
|
"type": "boolean", |
|
"description": "当前用户是否为此流程发起人" |
|
}, |
|
{ |
|
"name": "limitedCompleteTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "限定完成时间" |
|
}, |
|
{ |
|
"name": "major", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "专业编码" |
|
}, |
|
{ |
|
"name": "majorId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "专业字典ID" |
|
}, |
|
{ |
|
"name": "majorName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "专业名称" |
|
}, |
|
{ |
|
"name": "pointsAwarded", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "奖励积分" |
|
}, |
|
{ |
|
"name": "pointsStatus", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "积分发放状态编码" |
|
}, |
|
{ |
|
"name": "pointsStatusId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "积分发放状态字典ID" |
|
}, |
|
{ |
|
"name": "pointsStatusName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "积分发放状态名称" |
|
}, |
|
{ |
|
"name": "preventiveMeasures", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "防范措施" |
|
}, |
|
{ |
|
"name": "pushResponse", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "第三方返回结果" |
|
}, |
|
{ |
|
"name": "pushStatus", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "推送状态编码" |
|
}, |
|
{ |
|
"name": "pushStatusId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "推送状态字典ID" |
|
}, |
|
{ |
|
"name": "pushStatusName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "推送状态名称" |
|
}, |
|
{ |
|
"name": "pushTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "推送时间" |
|
}, |
|
{ |
|
"name": "rectificationPlan", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "整改方案" |
|
}, |
|
{ |
|
"name": "remark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "备注" |
|
}, |
|
{ |
|
"name": "reportNo", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患编号" |
|
}, |
|
{ |
|
"name": "reporterId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "上报人用户ID" |
|
}, |
|
{ |
|
"name": "reporterName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "上报人姓名" |
|
}, |
|
{ |
|
"name": "reporterUsername", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "上报人账号" |
|
}, |
|
{ |
|
"name": "riskTarget", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "风险分析对象" |
|
}, |
|
{ |
|
"name": "riskUnit", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "风险分析单元" |
|
}, |
|
{ |
|
"name": "sourceType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患来源编码" |
|
}, |
|
{ |
|
"name": "sourceTypeId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "隐患来源字典ID" |
|
}, |
|
{ |
|
"name": "sourceTypeName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患来源名称" |
|
}, |
|
{ |
|
"name": "status", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患状态编码" |
|
}, |
|
{ |
|
"name": "statusId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "隐患状态字典ID" |
|
}, |
|
{ |
|
"name": "statusName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患状态名称" |
|
}, |
|
{ |
|
"name": "supervisorId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "监察人用户ID" |
|
}, |
|
{ |
|
"name": "supervisorName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "监察人姓名" |
|
}, |
|
{ |
|
"name": "supervisorUsername", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "监察人账号" |
|
}, |
|
{ |
|
"name": "thirdPartyId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "第三方系统记录ID" |
|
}, |
|
{ |
|
"name": "unitId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "单位ID" |
|
}, |
|
{ |
|
"name": "unitName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "单位名称" |
|
}, |
|
{ |
|
"name": "updateBy", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "更新者" |
|
}, |
|
{ |
|
"name": "updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "更新时间" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "隐患信息管理", |
|
"name": "查询我的上报记录(APP端)", |
|
"usage": "分页查询当前登录用户已上报的隐患记录列表。返回 data 为 PageInfo 分页对象,包含 total/list/pageNum/pageSize 等。list 中每条记录为 HazardReport 对象,主要字段:id、reportNo、hazardName、status-状态编码、statusName-状态名称、hazardLevelName-级别名称、pointsAwarded-奖励积分、createTime-创建时间。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/hazard/myList", |
|
"operationId": "myListUsingGET_1", |
|
"parameters": [ |
|
{ |
|
"name": "actualCompleteTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "实际完成时间" |
|
}, |
|
{ |
|
"name": "attachments[0].attachmentType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "附件类型:IMAGE-图片 VIDEO-视频 DOCUMENT-文档 OTHER-其他" |
|
}, |
|
{ |
|
"name": "attachments[0].createBy", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "创建者" |
|
}, |
|
{ |
|
"name": "attachments[0].createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "attachments[0].fileName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "文件原始名称" |
|
}, |
|
{ |
|
"name": "attachments[0].filePath", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "文件存储路径" |
|
}, |
|
{ |
|
"name": "attachments[0].fileSize", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "文件大小(字节)" |
|
}, |
|
{ |
|
"name": "attachments[0].fileType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "文件MIME类型" |
|
}, |
|
{ |
|
"name": "attachments[0].id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "attachments[0].remark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "备注" |
|
}, |
|
{ |
|
"name": "attachments[0].reportId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "关联隐患ID" |
|
}, |
|
{ |
|
"name": "attachments[0].sortOrder", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "排序" |
|
}, |
|
{ |
|
"name": "attachments[0].suffix", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "文件后缀" |
|
}, |
|
{ |
|
"name": "attachments[0].updateBy", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "更新者" |
|
}, |
|
{ |
|
"name": "attachments[0].updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "更新时间" |
|
}, |
|
{ |
|
"name": "attachments[0].uploadUserId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "上传人用户ID" |
|
}, |
|
{ |
|
"name": "auditRemark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "审核备注" |
|
}, |
|
{ |
|
"name": "auditTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "审核时间" |
|
}, |
|
{ |
|
"name": "auditUserId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "审核人用户ID" |
|
}, |
|
{ |
|
"name": "auditUserName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "审核人姓名" |
|
}, |
|
{ |
|
"name": "auditUserUsername", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "审核人账号" |
|
}, |
|
{ |
|
"name": "canApprove", |
|
"in": "query", |
|
"required": false, |
|
"type": "boolean", |
|
"description": "当前用户是否可审批此流程" |
|
}, |
|
{ |
|
"name": "causeAnalysis", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "原因分析" |
|
}, |
|
{ |
|
"name": "chargePersonId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "整改负责人用户ID" |
|
}, |
|
{ |
|
"name": "chargePersonName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "整改负责人姓名" |
|
}, |
|
{ |
|
"name": "chargePersonUsername", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "整改负责人账号" |
|
}, |
|
{ |
|
"name": "createBy", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "创建者" |
|
}, |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "criteriaIds", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "判定标准ID(多选,逗号分隔)" |
|
}, |
|
{ |
|
"name": "criteriaNames", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "判定标准名称" |
|
}, |
|
{ |
|
"name": "currentFlowLevel", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "当前流程等级编码(general/major/critical)" |
|
}, |
|
{ |
|
"name": "departmentId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "部门ID" |
|
}, |
|
{ |
|
"name": "departmentName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "部门名称" |
|
}, |
|
{ |
|
"name": "deployId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "流程模板id" |
|
}, |
|
{ |
|
"name": "description", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患描述" |
|
}, |
|
{ |
|
"name": "discoverTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "发现时间" |
|
}, |
|
{ |
|
"name": "factoryDeptId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "所属厂区部门ID" |
|
}, |
|
{ |
|
"name": "factoryDeptName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "所属厂区部门名称" |
|
}, |
|
{ |
|
"name": "finalFlowLevel", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "审批最终等级名称(如一般-A档)" |
|
}, |
|
{ |
|
"name": "finalFlowLevelId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "审批最终积分规则ID(关联积分规则表)" |
|
}, |
|
{ |
|
"name": "flowInstanceId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "流程实例id" |
|
}, |
|
{ |
|
"name": "flowStatus", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "流程状态(0-未开始 1-进行中 2-已完成)" |
|
}, |
|
{ |
|
"name": "fundsSource", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "资金来源编码" |
|
}, |
|
{ |
|
"name": "fundsSourceId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "资金来源字典ID" |
|
}, |
|
{ |
|
"name": "fundsSourceName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "资金来源名称" |
|
}, |
|
{ |
|
"name": "governanceType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "治理类型编码" |
|
}, |
|
{ |
|
"name": "governanceTypeId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "治理类型字典ID" |
|
}, |
|
{ |
|
"name": "governanceTypeName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "治理类型名称" |
|
}, |
|
{ |
|
"name": "hazardCategory", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患分类编码(general/major/critical)" |
|
}, |
|
{ |
|
"name": "hazardCategoryId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "隐患分类根规则ID(关联积分规则表)" |
|
}, |
|
{ |
|
"name": "hazardCategoryName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患分类名称" |
|
}, |
|
{ |
|
"name": "hazardLevel", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "管理级别编码" |
|
}, |
|
{ |
|
"name": "hazardLevelId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "管理级别字典ID" |
|
}, |
|
{ |
|
"name": "hazardLevelName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "管理级别名称" |
|
}, |
|
{ |
|
"name": "hazardName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患名称" |
|
}, |
|
{ |
|
"name": "hazardSourceDetail", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "来源具体描述" |
|
}, |
|
{ |
|
"name": "hazardType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患类型编码" |
|
}, |
|
{ |
|
"name": "hazardTypeId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "隐患类型字典ID" |
|
}, |
|
{ |
|
"name": "hazardTypeName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患类型名称" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "isInitiator", |
|
"in": "query", |
|
"required": false, |
|
"type": "boolean", |
|
"description": "当前用户是否为此流程发起人" |
|
}, |
|
{ |
|
"name": "limitedCompleteTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "限定完成时间" |
|
}, |
|
{ |
|
"name": "major", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "专业编码" |
|
}, |
|
{ |
|
"name": "majorId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "专业字典ID" |
|
}, |
|
{ |
|
"name": "majorName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "专业名称" |
|
}, |
|
{ |
|
"name": "pageNum", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "页码" |
|
}, |
|
{ |
|
"name": "pointsAwarded", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "奖励积分" |
|
}, |
|
{ |
|
"name": "pointsStatus", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "积分发放状态编码" |
|
}, |
|
{ |
|
"name": "pointsStatusId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "积分发放状态字典ID" |
|
}, |
|
{ |
|
"name": "pointsStatusName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "积分发放状态名称" |
|
}, |
|
{ |
|
"name": "preventiveMeasures", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "防范措施" |
|
}, |
|
{ |
|
"name": "pushResponse", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "第三方返回结果" |
|
}, |
|
{ |
|
"name": "pushStatus", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "推送状态编码" |
|
}, |
|
{ |
|
"name": "pushStatusId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "推送状态字典ID" |
|
}, |
|
{ |
|
"name": "pushStatusName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "推送状态名称" |
|
}, |
|
{ |
|
"name": "pushTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "推送时间" |
|
}, |
|
{ |
|
"name": "rectificationPlan", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "整改方案" |
|
}, |
|
{ |
|
"name": "remark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "备注" |
|
}, |
|
{ |
|
"name": "reportNo", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患编号" |
|
}, |
|
{ |
|
"name": "reporterId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "上报人用户ID" |
|
}, |
|
{ |
|
"name": "reporterName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "上报人姓名" |
|
}, |
|
{ |
|
"name": "reporterUsername", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "上报人账号" |
|
}, |
|
{ |
|
"name": "riskTarget", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "风险分析对象" |
|
}, |
|
{ |
|
"name": "riskUnit", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "风险分析单元" |
|
}, |
|
{ |
|
"name": "sourceType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患来源编码" |
|
}, |
|
{ |
|
"name": "sourceTypeId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "隐患来源字典ID" |
|
}, |
|
{ |
|
"name": "sourceTypeName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患来源名称" |
|
}, |
|
{ |
|
"name": "status", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患状态编码" |
|
}, |
|
{ |
|
"name": "statusId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "隐患状态字典ID" |
|
}, |
|
{ |
|
"name": "statusName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患状态名称" |
|
}, |
|
{ |
|
"name": "supervisorId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "监察人用户ID" |
|
}, |
|
{ |
|
"name": "supervisorName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "监察人姓名" |
|
}, |
|
{ |
|
"name": "supervisorUsername", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "监察人账号" |
|
}, |
|
{ |
|
"name": "thirdPartyId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "第三方系统记录ID" |
|
}, |
|
{ |
|
"name": "unitId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "单位ID" |
|
}, |
|
{ |
|
"name": "unitName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "单位名称" |
|
}, |
|
{ |
|
"name": "updateBy", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "更新者" |
|
}, |
|
{ |
|
"name": "updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "更新时间" |
|
}, |
|
{ |
|
"name": "pageSize", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "每页数量" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "隐患信息管理", |
|
"name": "首页今日概览-我的隐患统计(APP端)", |
|
"usage": "按状态分类统计当前登录用户的隐患数量。返回字段说明:todayReportCount-今日上报数、pendingAuditCount-待审核数、rectifyingCount-整改中数、rejectedCount-已驳回数。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/hazard/myStats", |
|
"operationId": "myStatsUsingGET", |
|
"parameters": [], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "隐患信息管理", |
|
"name": "逻辑删除", |
|
"usage": "根据主键ID逻辑删除单条记录,成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/hazard/removeById", |
|
"operationId": "deleteListUsingGET_16", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "主键ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "隐患信息管理", |
|
"name": "保存隐患信息(草稿,不启动流程)", |
|
"usage": "保存隐患记录及附件,不启动审批流程。返回 data 为 HazardReport 对象,包含 id、reportNo 等完整隐患字段。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/hazard/save", |
|
"operationId": "saveUsingPOST_1", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "隐患上报请求" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "隐患信息管理", |
|
"name": "修改", |
|
"usage": "根据主键ID修改记录,请求体为实体类对象(需包含id字段)。成功返回 data 为 null。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/hazard/updateById", |
|
"operationId": "updateByIdUsingPOST_8", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "隐患信息" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "隐患信息管理", |
|
"name": "上传隐患附件文件", |
|
"usage": "上传文件到服务器,返回 data 为 HazardAttachment 数组,每个元素包含:id、fileName-文件名、filePath-文件路径、fileSize-文件大小、fileType-MIME类型、attachmentType-附件类型。前端在调用 save 或 submitFlow 时将附件数据传入", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/hazard/uploadAttachment", |
|
"operationId": "uploadAttachmentUsingPOST", |
|
"parameters": [ |
|
{ |
|
"name": "attachmentType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "附件类型:IMAGE-图片 VIDEO-视频 DOCUMENT-文档 OTHER-其他" |
|
} |
|
], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "string / binary" |
|
}, |
|
{ |
|
"contentType": "application/octet-stream", |
|
"schema": "string / binary" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "隐患信息管理", |
|
"name": "删除隐患(级联删除附件)", |
|
"usage": "返回 data 为 boolean,true-删除成功,false-删除失败。同时级联删除关联的附件记录。", |
|
"method": "DELETE", |
|
"path": "/gd_dataserver/gd_dataserver/business/hazard/{ids}", |
|
"operationId": "removeUsingDELETE", |
|
"parameters": [ |
|
{ |
|
"name": "ids", |
|
"in": "path", |
|
"required": true, |
|
"type": "string", |
|
"description": "隐患ID列表(逗号分隔)" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "204", |
|
"description": "No Content", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "商城端接口对接", |
|
"name": "扣减积分", |
|
"usage": "商城端在用户下单成功后调用此接口扣减积分,具有幂等性,同一orderNum多次调用只扣减一次", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/mall/api/points/deduct", |
|
"operationId": "deductPointsUsingPOST", |
|
"parameters": [ |
|
{ |
|
"name": "token", |
|
"in": "header", |
|
"required": true, |
|
"type": "-", |
|
"description": "用户身份令牌" |
|
} |
|
], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "商城端-积分操作请求" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "商城端接口统一响应«Void»" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "商城端接口对接", |
|
"name": "退还积分", |
|
"usage": "商城端在用户退款时调用此接口退还积分,具有幂等性,同一orderNum多次调用只退还一次", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/mall/api/points/refund", |
|
"operationId": "refundPointsUsingPOST", |
|
"parameters": [ |
|
{ |
|
"name": "token", |
|
"in": "header", |
|
"required": true, |
|
"type": "-", |
|
"description": "用户身份令牌" |
|
} |
|
], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "商城端-积分操作请求" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "商城端接口统一响应«Void»" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "商城端接口对接", |
|
"name": "根据Token获取用户信息", |
|
"usage": "商城端通过请求头中的Token获取用户基本信息,包括姓名、手机号、SAP编号等", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/mall/api/user/info", |
|
"operationId": "getUserInfoUsingPOST", |
|
"parameters": [ |
|
{ |
|
"name": "token", |
|
"in": "header", |
|
"required": true, |
|
"type": "-", |
|
"description": "用户身份令牌" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "商城端接口统一响应«商城端-用户信息»" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "商城端接口对接", |
|
"name": "根据Token获取用户积分信息", |
|
"usage": "商城端通过请求头中的Token及Body中的sap获取用户积分余额,包括可用积分、冻结积分等", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/mall/api/user/points", |
|
"operationId": "getUserPointsUsingPOST", |
|
"parameters": [ |
|
{ |
|
"name": "token", |
|
"in": "header", |
|
"required": true, |
|
"type": "-", |
|
"description": "用户身份令牌" |
|
} |
|
], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "商城端-积分操作请求" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "商城端接口统一响应«商城端-用户积分信息»" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "消息处理接口", |
|
"name": "MQTT消息发送", |
|
"usage": "向指定主题发送MQTT消息", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/mqtt/sendMqttMsg", |
|
"operationId": "sendMqttMsgUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "topic", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "MQTT主题" |
|
}, |
|
{ |
|
"name": "data", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "消息内容(JSON格式)" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分申诉管理", |
|
"name": "受理申诉", |
|
"usage": "将申诉状态从待受理(0)改为处理中(1)。返回 data 为 boolean。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/appeal/accept/{id}", |
|
"operationId": "acceptAppealUsingPOST", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "path", |
|
"required": true, |
|
"type": "integer / int64", |
|
"description": "申诉ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分申诉管理", |
|
"name": "新增", |
|
"usage": "新增单条记录,请求体为实体类对象(字段说明见对应实体模型)。成功返回 data 为 null。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/appeal/add", |
|
"operationId": "addOneUsingPOST_9", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "积分申诉" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分申诉管理", |
|
"name": "批量新增", |
|
"usage": "批量新增多条记录,请求体为实体类数组。成功返回 data 为 null。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/appeal/addBatch", |
|
"operationId": "addBatchUsingPOST_9", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "array<积分申诉>" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分申诉管理", |
|
"name": "新增并返回保存的数据", |
|
"usage": "新增单条记录并返回保存后的数据(含自增ID),请求体为实体类对象。成功返回 data 为保存的实体对象。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/appeal/addReturn", |
|
"operationId": "addReturnUsingPOST_9", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "积分申诉" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分申诉管理", |
|
"name": "审批申诉流程", |
|
"usage": "审批通过或驳回申诉流程节点。成功返回 data 为 null;失败返回 error 信息。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/appeal/completeFlow", |
|
"operationId": "completeFlowUsingPOST", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "工作流签字任务相关--请求参数" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分申诉管理", |
|
"name": "根据属性删除", |
|
"usage": "根据实体属性条件删除记录,请求体为实体类对象。成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/appeal/delete", |
|
"operationId": "deleteUsingGET_9", |
|
"parameters": [ |
|
{ |
|
"name": "adjustPoints", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "调整积分(正数补发,负数扣减)" |
|
}, |
|
{ |
|
"name": "appealNo", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "申诉编号" |
|
}, |
|
{ |
|
"name": "appealReason", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "申诉理由" |
|
}, |
|
{ |
|
"name": "appealType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "申诉类型:REJECT-审核驳回申诉 POINTS-积分异议 OTHER-其他" |
|
}, |
|
{ |
|
"name": "attachmentUrls", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "附件URL(JSON数组)" |
|
}, |
|
{ |
|
"name": "canApprove", |
|
"in": "query", |
|
"required": false, |
|
"type": "boolean", |
|
"description": "当前用户是否可审批此流程" |
|
}, |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "flowInstanceId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "流程实例ID(预留)" |
|
}, |
|
{ |
|
"name": "flowStatus", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "流程状态:0-无流程 1-进行中 2-已完成" |
|
}, |
|
{ |
|
"name": "handleRemark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "处理意见/结果说明" |
|
}, |
|
{ |
|
"name": "handleTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "处理时间" |
|
}, |
|
{ |
|
"name": "handleUserId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "处理人用户ID" |
|
}, |
|
{ |
|
"name": "handleUserName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "处理人姓名" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "isInitiator", |
|
"in": "query", |
|
"required": false, |
|
"type": "boolean", |
|
"description": "当前用户是否为此流程发起人" |
|
}, |
|
{ |
|
"name": "reportId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "关联隐患上报ID" |
|
}, |
|
{ |
|
"name": "reportNo", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "关联隐患编号" |
|
}, |
|
{ |
|
"name": "status", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "申诉状态:0-待受理 1-处理中 2-已通过 3-已驳回 4-已撤回" |
|
}, |
|
{ |
|
"name": "statusName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "申诉状态名称" |
|
}, |
|
{ |
|
"name": "updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "更新时间" |
|
}, |
|
{ |
|
"name": "userId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "申诉人用户ID" |
|
}, |
|
{ |
|
"name": "userName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "申诉人姓名" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分申诉管理", |
|
"name": "主键删除", |
|
"usage": "根据主键ID删除单条记录,成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/appeal/deleteById", |
|
"operationId": "deleteOneUsingGET_9", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "主键ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分申诉管理", |
|
"name": "批量删除", |
|
"usage": "根据ID列表批量删除记录,成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/appeal/deleteByIds", |
|
"operationId": "deleteListUsingGET_19", |
|
"parameters": [ |
|
{ |
|
"name": "ids", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "ID列表(逗号分隔)" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分申诉管理", |
|
"name": "获取申诉详情", |
|
"usage": "返回 data 为 PointsAppeal 对象,包含完整申诉字段及流程进度信息。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/appeal/detail/{id}", |
|
"operationId": "getDetailUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "path", |
|
"required": true, |
|
"type": "integer / int64", |
|
"description": "申诉ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分申诉管理", |
|
"name": "查询所有", |
|
"usage": "查询所有记录(无分页、无条件)。成功返回 data 为实体类数组。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/appeal/getAll", |
|
"operationId": "getAllUsingGET_9", |
|
"parameters": [], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分申诉管理", |
|
"name": "分页查询", |
|
"usage": "分页查询记录列表,查询条件为实体类字段。成功返回 data 为 PageInfo 分页对象,其中 list 为实体类数组。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/appeal/getListByPage", |
|
"operationId": "getListByPageUsingGET_9", |
|
"parameters": [ |
|
{ |
|
"name": "adjustPoints", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "调整积分(正数补发,负数扣减)" |
|
}, |
|
{ |
|
"name": "appealNo", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "申诉编号" |
|
}, |
|
{ |
|
"name": "appealReason", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "申诉理由" |
|
}, |
|
{ |
|
"name": "appealType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "申诉类型:REJECT-审核驳回申诉 POINTS-积分异议 OTHER-其他" |
|
}, |
|
{ |
|
"name": "attachmentUrls", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "附件URL(JSON数组)" |
|
}, |
|
{ |
|
"name": "canApprove", |
|
"in": "query", |
|
"required": false, |
|
"type": "boolean", |
|
"description": "当前用户是否可审批此流程" |
|
}, |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "flowInstanceId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "流程实例ID(预留)" |
|
}, |
|
{ |
|
"name": "flowStatus", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "流程状态:0-无流程 1-进行中 2-已完成" |
|
}, |
|
{ |
|
"name": "handleRemark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "处理意见/结果说明" |
|
}, |
|
{ |
|
"name": "handleTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "处理时间" |
|
}, |
|
{ |
|
"name": "handleUserId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "处理人用户ID" |
|
}, |
|
{ |
|
"name": "handleUserName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "处理人姓名" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "isInitiator", |
|
"in": "query", |
|
"required": false, |
|
"type": "boolean", |
|
"description": "当前用户是否为此流程发起人" |
|
}, |
|
{ |
|
"name": "pageNum", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "页码" |
|
}, |
|
{ |
|
"name": "reportId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "关联隐患上报ID" |
|
}, |
|
{ |
|
"name": "reportNo", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "关联隐患编号" |
|
}, |
|
{ |
|
"name": "status", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "申诉状态:0-待受理 1-处理中 2-已通过 3-已驳回 4-已撤回" |
|
}, |
|
{ |
|
"name": "statusName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "申诉状态名称" |
|
}, |
|
{ |
|
"name": "updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "更新时间" |
|
}, |
|
{ |
|
"name": "userId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "申诉人用户ID" |
|
}, |
|
{ |
|
"name": "userName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "申诉人姓名" |
|
}, |
|
{ |
|
"name": "pageSize", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "每页条数" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分申诉管理", |
|
"name": "处理申诉", |
|
"usage": "通过或驳回申诉,可选调整积分。approved=true时状态改为已通过(2),approved=false时改为已驳回(3)。adjustPoints为正数补发积分,负数扣减积分,不传则不调整。返回 data 为 boolean。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/appeal/handle/{id}", |
|
"operationId": "handleAppealUsingPOST", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "path", |
|
"required": true, |
|
"type": "integer / int64", |
|
"description": "申诉ID" |
|
}, |
|
{ |
|
"name": "approved", |
|
"in": "query", |
|
"required": true, |
|
"type": "boolean", |
|
"description": "是否通过" |
|
}, |
|
{ |
|
"name": "handleRemark", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "处理意见" |
|
}, |
|
{ |
|
"name": "adjustPoints", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "调整积分(正数补发,负数扣减,不传则不调整)" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分申诉管理", |
|
"name": "详情", |
|
"usage": "根据主键ID查询单条记录详情。成功返回 data 为实体类对象,包含该实体所有字段。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/appeal/info", |
|
"operationId": "infoUsingGET_9", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "主键ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分申诉管理", |
|
"name": "条件查询", |
|
"usage": "根据实体属性条件查询记录列表。成功返回 data 为实体类数组。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/appeal/list", |
|
"operationId": "getListUsingGET_9", |
|
"parameters": [ |
|
{ |
|
"name": "adjustPoints", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "调整积分(正数补发,负数扣减)" |
|
}, |
|
{ |
|
"name": "appealNo", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "申诉编号" |
|
}, |
|
{ |
|
"name": "appealReason", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "申诉理由" |
|
}, |
|
{ |
|
"name": "appealType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "申诉类型:REJECT-审核驳回申诉 POINTS-积分异议 OTHER-其他" |
|
}, |
|
{ |
|
"name": "attachmentUrls", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "附件URL(JSON数组)" |
|
}, |
|
{ |
|
"name": "canApprove", |
|
"in": "query", |
|
"required": false, |
|
"type": "boolean", |
|
"description": "当前用户是否可审批此流程" |
|
}, |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "flowInstanceId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "流程实例ID(预留)" |
|
}, |
|
{ |
|
"name": "flowStatus", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "流程状态:0-无流程 1-进行中 2-已完成" |
|
}, |
|
{ |
|
"name": "handleRemark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "处理意见/结果说明" |
|
}, |
|
{ |
|
"name": "handleTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "处理时间" |
|
}, |
|
{ |
|
"name": "handleUserId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "处理人用户ID" |
|
}, |
|
{ |
|
"name": "handleUserName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "处理人姓名" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "isInitiator", |
|
"in": "query", |
|
"required": false, |
|
"type": "boolean", |
|
"description": "当前用户是否为此流程发起人" |
|
}, |
|
{ |
|
"name": "reportId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "关联隐患上报ID" |
|
}, |
|
{ |
|
"name": "reportNo", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "关联隐患编号" |
|
}, |
|
{ |
|
"name": "status", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "申诉状态:0-待受理 1-处理中 2-已通过 3-已驳回 4-已撤回" |
|
}, |
|
{ |
|
"name": "statusName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "申诉状态名称" |
|
}, |
|
{ |
|
"name": "updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "更新时间" |
|
}, |
|
{ |
|
"name": "userId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "申诉人用户ID" |
|
}, |
|
{ |
|
"name": "userName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "申诉人姓名" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分申诉管理", |
|
"name": "查询我的申诉记录(APP端)", |
|
"usage": "返回 data 为 PageInfo 分页对象。list 中每条记录为 PointsAppeal 对象,主要字段:id、appealNo-申诉编号、appealType-申诉类型(REJECT/POINTS/OTHER)、status-状态(0待受理/1处理中/2已通过/3已驳回/4已撤回)、statusName-状态名称、handleRemark-处理意见、adjustPoints-调整积分、createTime。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/appeal/myList", |
|
"operationId": "myListUsingGET_2", |
|
"parameters": [ |
|
{ |
|
"name": "adjustPoints", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "调整积分(正数补发,负数扣减)" |
|
}, |
|
{ |
|
"name": "appealNo", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "申诉编号" |
|
}, |
|
{ |
|
"name": "appealReason", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "申诉理由" |
|
}, |
|
{ |
|
"name": "appealType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "申诉类型:REJECT-审核驳回申诉 POINTS-积分异议 OTHER-其他" |
|
}, |
|
{ |
|
"name": "attachmentUrls", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "附件URL(JSON数组)" |
|
}, |
|
{ |
|
"name": "canApprove", |
|
"in": "query", |
|
"required": false, |
|
"type": "boolean", |
|
"description": "当前用户是否可审批此流程" |
|
}, |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "flowInstanceId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "流程实例ID(预留)" |
|
}, |
|
{ |
|
"name": "flowStatus", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "流程状态:0-无流程 1-进行中 2-已完成" |
|
}, |
|
{ |
|
"name": "handleRemark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "处理意见/结果说明" |
|
}, |
|
{ |
|
"name": "handleTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "处理时间" |
|
}, |
|
{ |
|
"name": "handleUserId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "处理人用户ID" |
|
}, |
|
{ |
|
"name": "handleUserName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "处理人姓名" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "isInitiator", |
|
"in": "query", |
|
"required": false, |
|
"type": "boolean", |
|
"description": "当前用户是否为此流程发起人" |
|
}, |
|
{ |
|
"name": "pageNum", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "页码" |
|
}, |
|
{ |
|
"name": "reportId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "关联隐患上报ID" |
|
}, |
|
{ |
|
"name": "reportNo", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "关联隐患编号" |
|
}, |
|
{ |
|
"name": "status", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "申诉状态:0-待受理 1-处理中 2-已通过 3-已驳回 4-已撤回" |
|
}, |
|
{ |
|
"name": "statusName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "申诉状态名称" |
|
}, |
|
{ |
|
"name": "updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "更新时间" |
|
}, |
|
{ |
|
"name": "userId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "申诉人用户ID" |
|
}, |
|
{ |
|
"name": "userName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "申诉人姓名" |
|
}, |
|
{ |
|
"name": "pageSize", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "每页数量" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分申诉管理", |
|
"name": "逻辑删除", |
|
"usage": "根据主键ID逻辑删除单条记录,成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/appeal/removeById", |
|
"operationId": "deleteListUsingGET_18", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "主键ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分申诉管理", |
|
"name": "提交申诉(APP端)", |
|
"usage": "填写申诉类型、理由等信息,申诉人信息从登录用户获取。返回 data 为 PointsAppeal 对象,包含 id、appealNo-申诉编号、status-状态(0待受理)。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/appeal/submit", |
|
"operationId": "submitAppealUsingPOST", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "积分申诉" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分申诉管理", |
|
"name": "提交申诉并启动流程(APP端)", |
|
"usage": "提交申诉并自动启动 Flowable 审批流程。成功返回 data 为流程实例ID字符串;失败返回 error 信息。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/appeal/submitFlow", |
|
"operationId": "submitAppealFlowUsingPOST", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "积分申诉" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分申诉管理", |
|
"name": "申诉流程待办列表", |
|
"usage": "返回 data 为 PageInfo 分页对象。list 中每条记录为 PointsAppeal 对象,包含 id、appealNo、userName、appealType-申诉类型、appealReason-申诉理由、status-状态、createTime。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/appeal/todoList", |
|
"operationId": "todoListUsingGET_2", |
|
"parameters": [ |
|
{ |
|
"name": "params", |
|
"in": "query", |
|
"required": true, |
|
"type": "object<string, string>", |
|
"description": "查询参数(支持pageNum/pageSize等)" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分申诉管理", |
|
"name": "修改", |
|
"usage": "根据主键ID修改记录,请求体为实体类对象(需包含id字段)。成功返回 data 为 null。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/appeal/updateById", |
|
"operationId": "updateByIdUsingPOST_9", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "积分申诉" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分申诉管理", |
|
"name": "撤回申诉(APP端)", |
|
"usage": "仅待受理状态(status=0)可撤回,撤回后状态改为已撤回(4)。返回 data 为 boolean。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/appeal/withdraw/{id}", |
|
"operationId": "withdrawAppealUsingPOST", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "path", |
|
"required": true, |
|
"type": "integer / int64", |
|
"description": "申诉ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分规则配置", |
|
"name": "新增积分规则", |
|
"usage": "二级管理员自动填充厂区信息,且不可创建全局兜底规则;超级管理员可指定 deptId(为空表示全局兜底规则)。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/rule/add", |
|
"operationId": "addUsingPOST", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "积分规则配置" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分规则配置", |
|
"name": "计算积分", |
|
"usage": "根据厂区、隐患等级和类别查询对应奖励积分。二级管理员调用时 deptId 自动填充为所属厂区,超管可传任意厂区(不传则匹配全局兜底)。返回 data 为 Integer 类型的积分数值。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/rule/calculatePoints", |
|
"operationId": "calculatePointsUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "deptId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "厂区部门ID(二级管理员忽略此参数)" |
|
}, |
|
{ |
|
"name": "hazardLevel", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "隐患等级编码" |
|
}, |
|
{ |
|
"name": "hazardCategory", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "隐患类别编码" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分规则配置", |
|
"name": "删除积分规则", |
|
"usage": "根据主键ID物理删除。二级管理员只能删除本厂区规则;全局兜底规则仅超级管理员可删除。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/rule/deleteById", |
|
"operationId": "deleteByIdUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "主键ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分规则配置", |
|
"name": "分页查询积分规则(兼容旧路径)", |
|
"usage": "同 /list 接口,保留用于前端旧路径兼容。二级管理员自动过滤本厂区。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/rule/getListByPage", |
|
"operationId": "getListByPageUsingGET_10", |
|
"parameters": [ |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "deptId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "所属厂区部门ID(NULL表示全局兜底规则,二级管理员新增时自动填充)" |
|
}, |
|
{ |
|
"name": "deptName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "所属厂区部门名称" |
|
}, |
|
{ |
|
"name": "enabled", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "是否启用:0-禁用 1-启用" |
|
}, |
|
{ |
|
"name": "hazardCategory", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患类别" |
|
}, |
|
{ |
|
"name": "hazardLevel", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患等级编码(general/major/critical)" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "pageNum", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "页码" |
|
}, |
|
{ |
|
"name": "points", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "奖励积分" |
|
}, |
|
{ |
|
"name": "priority", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "优先级(数字越大优先级越高)" |
|
}, |
|
{ |
|
"name": "remark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "备注" |
|
}, |
|
{ |
|
"name": "ruleCode", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "规则编码" |
|
}, |
|
{ |
|
"name": "ruleName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "规则名称" |
|
}, |
|
{ |
|
"name": "updateTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "更新时间" |
|
}, |
|
{ |
|
"name": "pageSize", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "每页条数" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分规则配置", |
|
"name": "获取积分规则详情", |
|
"usage": "根据主键ID查询规则详情。二级管理员访问非本厂区规则或全局兜底规则时返回错误。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/rule/info", |
|
"operationId": "infoUsingGET_10", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "主键ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分规则配置", |
|
"name": "分页查询积分规则列表", |
|
"usage": "超级管理员返回所有厂区规则(可按deptId筛选,传global表示查询全局兜底规则);二级管理员自动过滤为所属厂区规则。返回 data 为 PageInfo 分页对象。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/rule/list", |
|
"operationId": "listUsingGET_1", |
|
"parameters": [ |
|
{ |
|
"name": "pageNum", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "页码" |
|
}, |
|
{ |
|
"name": "pageSize", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "每页条数" |
|
}, |
|
{ |
|
"name": "deptId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "厂区部门ID(超管可传,二级管理员忽略;传 global 表示查询全局兜底规则)" |
|
}, |
|
{ |
|
"name": "hazardLevel", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患等级编码(general/major/critical)" |
|
}, |
|
{ |
|
"name": "hazardCategory", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患类别" |
|
}, |
|
{ |
|
"name": "enabled", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "是否启用:0-禁用 1-启用" |
|
}, |
|
{ |
|
"name": "ruleName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "规则名称(模糊匹配)" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分规则配置", |
|
"name": "查询当前厂区所有积分规则", |
|
"usage": "返回当前登录用户所属厂区的规则列表,同时包含全局兜底规则(dept_id 为 NULL)。返回 data 为 PointsRuleConfig 数组。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/rule/myFactoryRules", |
|
"operationId": "myFactoryRulesUsingGET", |
|
"parameters": [], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分规则配置", |
|
"name": "获取隐患分类根规则列表", |
|
"usage": "返回当前用户厂区每个大类(一般/较大/重大)的最高优先级根规则,用于 APP 上报时隐患分类下拉选择。返回 data 为 PointsRuleConfig 数组(最多3条)。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/rule/rootRules", |
|
"operationId": "rootRulesUsingGET", |
|
"parameters": [], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分规则配置", |
|
"name": "获取积分规则树形结构", |
|
"usage": "返回当前用户厂区的积分规则树形结构,按大类(一般/较大/重大)分组,每个大类下包含子规则列表,用于审批时选择具体档次。返回 data 为数组,每项含 id/hazardLevel/hazardLevelName/ruleName/points/children。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/rule/ruleTree", |
|
"operationId": "ruleTreeUsingGET", |
|
"parameters": [], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分规则配置", |
|
"name": "启用/禁用积分规则", |
|
"usage": "enabled=1 启用,enabled=0 禁用。二级管理员只能操作本厂区规则。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/rule/toggleEnabled", |
|
"operationId": "toggleEnabledUsingPOST", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int64", |
|
"description": "规则ID" |
|
}, |
|
{ |
|
"name": "enabled", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "启用状态:0-禁用 1-启用" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分规则配置", |
|
"name": "积分规则试算", |
|
"usage": "模拟积分计算过程,返回匹配的规则详情和计算结果。返回 data 为对象:deptId-生效厂区、hazardLevel-输入的隐患等级、hazardCategory-输入的隐患类别、matchedRule-匹配到的规则对象或null、calculatedPoints-计算得到的积分数值(无匹配时为0)、matchScope-命中范围(FACTORY-厂区专属/GLOBAL-全局兜底/NONE-未命中)。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/rule/trialCalculate", |
|
"operationId": "trialCalculateUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "deptId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "厂区部门ID(二级管理员忽略此参数)" |
|
}, |
|
{ |
|
"name": "hazardLevel", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "隐患等级编码" |
|
}, |
|
{ |
|
"name": "hazardCategory", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "隐患类别编码" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分规则配置", |
|
"name": "修改积分规则", |
|
"usage": "二级管理员只能修改本厂区规则,不可变更所属厂区;超级管理员可任意修改。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/rule/updateById", |
|
"operationId": "updateByIdUsingPOST_10", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "积分规则配置" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分流水明细", |
|
"name": "新增", |
|
"usage": "新增单条记录,请求体为实体类对象(字段说明见对应实体模型)。成功返回 data 为 null。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/transaction/add", |
|
"operationId": "addOneUsingPOST_10", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "积分流水明细" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分流水明细", |
|
"name": "批量新增", |
|
"usage": "批量新增多条记录,请求体为实体类数组。成功返回 data 为 null。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/transaction/addBatch", |
|
"operationId": "addBatchUsingPOST_10", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "array<积分流水明细>" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分流水明细", |
|
"name": "新增并返回保存的数据", |
|
"usage": "新增单条记录并返回保存后的数据(含自增ID),请求体为实体类对象。成功返回 data 为保存的实体对象。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/transaction/addReturn", |
|
"operationId": "addReturnUsingPOST_10", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "积分流水明细" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分流水明细", |
|
"name": "根据属性删除", |
|
"usage": "根据实体属性条件删除记录,请求体为实体类对象。成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/transaction/delete", |
|
"operationId": "deleteUsingGET_10", |
|
"parameters": [ |
|
{ |
|
"name": "afterBalance", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "变动后可用余额" |
|
}, |
|
{ |
|
"name": "afterFrozen", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "变动后冻结余额" |
|
}, |
|
{ |
|
"name": "amount", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "变动积分(正数=入账,负数=出账)" |
|
}, |
|
{ |
|
"name": "beforeBalance", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "变动前可用余额" |
|
}, |
|
{ |
|
"name": "beforeFrozen", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "变动前冻结余额" |
|
}, |
|
{ |
|
"name": "bizId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "业务单号" |
|
}, |
|
{ |
|
"name": "bizType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "业务类型:REPORT-隐患上报奖励 EXCHANGE-兑换扣减 REFUND-退款回滚 FREEZE-冻结 UNFREEZE-解冻" |
|
}, |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "operator", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作人" |
|
}, |
|
{ |
|
"name": "remark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "备注" |
|
}, |
|
{ |
|
"name": "status", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "状态:1-有效 2-已冲正" |
|
}, |
|
{ |
|
"name": "txnNo", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "流水号" |
|
}, |
|
{ |
|
"name": "userId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "用户ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分流水明细", |
|
"name": "主键删除", |
|
"usage": "根据主键ID删除单条记录,成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/transaction/deleteById", |
|
"operationId": "deleteOneUsingGET_10", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "主键ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分流水明细", |
|
"name": "批量删除", |
|
"usage": "根据ID列表批量删除记录,成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/transaction/deleteByIds", |
|
"operationId": "deleteListUsingGET_21", |
|
"parameters": [ |
|
{ |
|
"name": "ids", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "ID列表(逗号分隔)" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分流水明细", |
|
"name": "查询所有", |
|
"usage": "查询所有记录(无分页、无条件)。成功返回 data 为实体类数组。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/transaction/getAll", |
|
"operationId": "getAllUsingGET_10", |
|
"parameters": [], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分流水明细", |
|
"name": "分页查询", |
|
"usage": "分页查询记录列表,查询条件为实体类字段。成功返回 data 为 PageInfo 分页对象,其中 list 为实体类数组。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/transaction/getListByPage", |
|
"operationId": "getListByPageUsingGET_11", |
|
"parameters": [ |
|
{ |
|
"name": "afterBalance", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "变动后可用余额" |
|
}, |
|
{ |
|
"name": "afterFrozen", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "变动后冻结余额" |
|
}, |
|
{ |
|
"name": "amount", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "变动积分(正数=入账,负数=出账)" |
|
}, |
|
{ |
|
"name": "beforeBalance", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "变动前可用余额" |
|
}, |
|
{ |
|
"name": "beforeFrozen", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "变动前冻结余额" |
|
}, |
|
{ |
|
"name": "bizId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "业务单号" |
|
}, |
|
{ |
|
"name": "bizType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "业务类型:REPORT-隐患上报奖励 EXCHANGE-兑换扣减 REFUND-退款回滚 FREEZE-冻结 UNFREEZE-解冻" |
|
}, |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "operator", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作人" |
|
}, |
|
{ |
|
"name": "pageNum", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "页码" |
|
}, |
|
{ |
|
"name": "remark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "备注" |
|
}, |
|
{ |
|
"name": "status", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "状态:1-有效 2-已冲正" |
|
}, |
|
{ |
|
"name": "txnNo", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "流水号" |
|
}, |
|
{ |
|
"name": "userId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "用户ID" |
|
}, |
|
{ |
|
"name": "pageSize", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "每页条数" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分流水明细", |
|
"name": "详情", |
|
"usage": "根据主键ID查询单条记录详情。成功返回 data 为实体类对象,包含该实体所有字段。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/transaction/info", |
|
"operationId": "infoUsingGET_11", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "主键ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分流水明细", |
|
"name": "条件查询", |
|
"usage": "根据实体属性条件查询记录列表。成功返回 data 为实体类数组。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/transaction/list", |
|
"operationId": "getListUsingGET_10", |
|
"parameters": [ |
|
{ |
|
"name": "afterBalance", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "变动后可用余额" |
|
}, |
|
{ |
|
"name": "afterFrozen", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "变动后冻结余额" |
|
}, |
|
{ |
|
"name": "amount", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "变动积分(正数=入账,负数=出账)" |
|
}, |
|
{ |
|
"name": "beforeBalance", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "变动前可用余额" |
|
}, |
|
{ |
|
"name": "beforeFrozen", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "变动前冻结余额" |
|
}, |
|
{ |
|
"name": "bizId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "业务单号" |
|
}, |
|
{ |
|
"name": "bizType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "业务类型:REPORT-隐患上报奖励 EXCHANGE-兑换扣减 REFUND-退款回滚 FREEZE-冻结 UNFREEZE-解冻" |
|
}, |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "operator", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作人" |
|
}, |
|
{ |
|
"name": "remark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "备注" |
|
}, |
|
{ |
|
"name": "status", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "状态:1-有效 2-已冲正" |
|
}, |
|
{ |
|
"name": "txnNo", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "流水号" |
|
}, |
|
{ |
|
"name": "userId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "用户ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分流水明细", |
|
"name": "查询我的积分流水(APP端)", |
|
"usage": "返回 data 为 PageInfo 分页对象。list 中每条记录为 PointsTransactionLog 对象,主要字段:txnNo-流水号、userId-用户ID、bizId-业务单号、bizType-业务类型(REPORT-上报奖励/EXCHANGE-兑换扣减/REFUND-退款/APPEAL_ADD-申诉补发/APPEAL_DEDUCT-申诉扣减/MALL_DEDUCT-商城扣减/MALL_REFUND-商城退款)、amount-变动积分(正=入账,负=出账)、beforeBalance-变动前余额、afterBalance-变动后余额、status-状态(1有效/2已冲正)、createTime-创建时间。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/transaction/myList", |
|
"operationId": "myListUsingGET_3", |
|
"parameters": [ |
|
{ |
|
"name": "afterBalance", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "变动后可用余额" |
|
}, |
|
{ |
|
"name": "afterFrozen", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "变动后冻结余额" |
|
}, |
|
{ |
|
"name": "amount", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "变动积分(正数=入账,负数=出账)" |
|
}, |
|
{ |
|
"name": "beforeBalance", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "变动前可用余额" |
|
}, |
|
{ |
|
"name": "beforeFrozen", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "变动前冻结余额" |
|
}, |
|
{ |
|
"name": "bizId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "业务单号" |
|
}, |
|
{ |
|
"name": "bizType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "业务类型:REPORT-隐患上报奖励 EXCHANGE-兑换扣减 REFUND-退款回滚 FREEZE-冻结 UNFREEZE-解冻" |
|
}, |
|
{ |
|
"name": "createTime", |
|
"in": "query", |
|
"required": false, |
|
"type": "string / date-time", |
|
"description": "创建时间" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "operator", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "操作人" |
|
}, |
|
{ |
|
"name": "pageNum", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "页码" |
|
}, |
|
{ |
|
"name": "remark", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "备注" |
|
}, |
|
{ |
|
"name": "status", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "状态:1-有效 2-已冲正" |
|
}, |
|
{ |
|
"name": "txnNo", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "流水号" |
|
}, |
|
{ |
|
"name": "userId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "用户ID" |
|
}, |
|
{ |
|
"name": "pageSize", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "每页数量" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分流水明细", |
|
"name": "逻辑删除", |
|
"usage": "根据主键ID逻辑删除单条记录,成功返回 data 为 null。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/transaction/removeById", |
|
"operationId": "deleteListUsingGET_20", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "主键ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分流水明细", |
|
"name": "积分冲正", |
|
"usage": "根据流水ID冲正该笔积分变动,原流水标记为已冲正(status=2),并生成反向流水。返回 data 为 boolean,true-冲正成功。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/transaction/reverse/{logId}", |
|
"operationId": "reverseTransactionUsingPOST", |
|
"parameters": [ |
|
{ |
|
"name": "logId", |
|
"in": "path", |
|
"required": true, |
|
"type": "integer / int64", |
|
"description": "原流水ID" |
|
}, |
|
{ |
|
"name": "reason", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "冲正原因" |
|
}, |
|
{ |
|
"name": "operator", |
|
"in": "query", |
|
"required": true, |
|
"type": "string", |
|
"description": "操作人" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "积分流水明细", |
|
"name": "修改", |
|
"usage": "根据主键ID修改记录,请求体为实体类对象(需包含id字段)。成功返回 data 为 null。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/points/transaction/updateById", |
|
"operationId": "updateByIdUsingPOST_11", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "积分流水明细" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "流程审批_签字", |
|
"name": "查询签字记录列表", |
|
"usage": "支持按条件筛选签字记录", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/flowqz/getList", |
|
"operationId": "getListUsingGET_11", |
|
"parameters": [ |
|
{ |
|
"name": "comment", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "意见" |
|
}, |
|
{ |
|
"name": "file", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "照片地址" |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int64", |
|
"description": "主键ID" |
|
}, |
|
{ |
|
"name": "instanceId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "流程实例Id" |
|
}, |
|
{ |
|
"name": "qz", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "签字" |
|
}, |
|
{ |
|
"name": "result", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "结果" |
|
}, |
|
{ |
|
"name": "taskId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "任务id" |
|
}, |
|
{ |
|
"name": "taskName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "任务名称" |
|
}, |
|
{ |
|
"name": "time", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "签字时间" |
|
}, |
|
{ |
|
"name": "type", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "业务类型" |
|
}, |
|
{ |
|
"name": "userId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "用户Id" |
|
}, |
|
{ |
|
"name": "userName", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "用户名称" |
|
}, |
|
{ |
|
"name": "zyxkid", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "作业许可id" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "隐患流程模板配置", |
|
"name": "修改流程模板配置", |
|
"usage": "修改流程Key、流程名称等信息。不可修改厂区ID和隐患等级。", |
|
"method": "PUT", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/hazardFlowConfig", |
|
"operationId": "editUsingPUT", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "隐患流程模板配置" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "隐患流程模板配置", |
|
"name": "新增流程模板配置", |
|
"usage": "配置某个厂区的某个隐患等级对应的Flowable流程Key。二级管理员无需传deptId/deptName,系统自动填充所属厂区。每个厂区的每个等级只能配置一条(唯一约束)。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/hazardFlowConfig", |
|
"operationId": "addUsingPOST_1", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "隐患流程模板配置" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "隐患流程模板配置", |
|
"name": "查询流程模板配置列表", |
|
"usage": "系统管理员返回所有配置;二级管理员自动过滤为所属厂区的配置。可选按厂区ID、隐患等级筛选。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/hazardFlowConfig/list", |
|
"operationId": "listUsingGET_2", |
|
"parameters": [ |
|
{ |
|
"name": "pageNum", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "当前页码" |
|
}, |
|
{ |
|
"name": "pageSize", |
|
"in": "query", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "每页条数" |
|
}, |
|
{ |
|
"name": "deptId", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "厂区部门ID(不传则按当前用户权限自动过滤)" |
|
}, |
|
{ |
|
"name": "hazardLevel", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "隐患等级编码(general/major/critical)" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "隐患流程模板配置", |
|
"name": "获取当前厂区已配置的流程模板", |
|
"usage": "前端上报隐患时调用,返回当前用户所属厂区已配置的隐患等级和对应流程信息,用于前端展示可选的隐患等级下拉。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/hazardFlowConfig/myFactoryConfigs", |
|
"operationId": "myFactoryConfigsUsingGET", |
|
"parameters": [], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "隐患流程模板配置", |
|
"name": "获取流程模板配置详情", |
|
"usage": "", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/hazardFlowConfig/{id}", |
|
"operationId": "getInfoUsingGET_1", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "path", |
|
"required": true, |
|
"type": "integer / int64", |
|
"description": "配置ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "隐患流程模板配置", |
|
"name": "删除流程模板配置", |
|
"usage": "逻辑删除,将状态置为停用。", |
|
"method": "DELETE", |
|
"path": "/gd_dataserver/gd_dataserver/flowable/hazardFlowConfig/{id}", |
|
"operationId": "removeUsingDELETE_1", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "path", |
|
"required": true, |
|
"type": "integer / int64", |
|
"description": "配置ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "204", |
|
"description": "No Content", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "系统工具", |
|
"name": "获取组织架构(部门-人员树)", |
|
"usage": "返回 data 为树形数组,每个节点包含 id-部门ID、label-部门名称、children-子节点数组。子节点包含部门或人员,人员节点包含 id-用户ID、label-用户姓名。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/system/getOrgUsers", |
|
"operationId": "getOrgUsersUsingGET", |
|
"parameters": [], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "array<object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "系统工具", |
|
"name": "获取当前登录用户信息", |
|
"usage": "返回 data 为 SysUser 对象,包含 userId-用户ID、userName-用户名、nickName-昵称、phonenumber-手机号、email-邮箱、dept-部门对象{deptId,deptName}等字段。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/system/getTokenUser", |
|
"operationId": "getTokenUserUsingGET", |
|
"parameters": [], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "sys-dept-controller", |
|
"name": "获取所有厂区级部门列表", |
|
"usage": "返回部门树中第二层(二级)的所有部门,供超级管理员在下拉框中选择厂区。厂区级定义:父节点为根级部门(parentId=0)的部门。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/system/dept/factoryList", |
|
"operationId": "factoryListUsingGET", |
|
"parameters": [], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "sys-dept-controller", |
|
"name": "获取当前用户所属厂区部门", |
|
"usage": "根据当前登录用户的部门信息,向上回溯到厂区级(二级)部门并返回。适用于非超级管理员获取自己所属厂区。返回 data 为 SysDept 对象,包含 deptId、deptName 等字段。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/system/dept/myFactory", |
|
"operationId": "myFactoryUsingGET", |
|
"parameters": [], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "test-controller-1", |
|
"name": "获取用户列表", |
|
"usage": "", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/test/user/list", |
|
"operationId": "userListUsingGET_1", |
|
"parameters": [], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "R«List«UserEntity»»" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "test-controller-1", |
|
"name": "新增用户", |
|
"usage": "", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/test/user/save", |
|
"operationId": "saveUsingPOST_2", |
|
"parameters": [ |
|
{ |
|
"name": "mobile", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "用户手机" |
|
}, |
|
{ |
|
"name": "password", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "用户密码" |
|
}, |
|
{ |
|
"name": "userId", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "用户id" |
|
}, |
|
{ |
|
"name": "username", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "用户名称" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "R«string»" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "test-controller-1", |
|
"name": "更新用户", |
|
"usage": "", |
|
"method": "PUT", |
|
"path": "/gd_dataserver/gd_dataserver/test/user/update", |
|
"operationId": "updateUsingPUT", |
|
"parameters": [], |
|
"requestBodies": [ |
|
{ |
|
"contentType": "application/json", |
|
"schema": "UserEntity" |
|
} |
|
], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "R«string»" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "test-controller-1", |
|
"name": "获取用户详细", |
|
"usage": "", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/test/user/{userId}", |
|
"operationId": "getUserUsingGET", |
|
"parameters": [ |
|
{ |
|
"name": "userId", |
|
"in": "path", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "用户ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "R«UserEntity»" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "test-controller-1", |
|
"name": "删除用户信息", |
|
"usage": "", |
|
"method": "DELETE", |
|
"path": "/gd_dataserver/gd_dataserver/test/user/{userId}", |
|
"operationId": "deleteUsingDELETE_2", |
|
"parameters": [ |
|
{ |
|
"name": "userId", |
|
"in": "path", |
|
"required": true, |
|
"type": "integer / int32", |
|
"description": "用户ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "R«string»" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "204", |
|
"description": "No Content", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "用户消息中心", |
|
"name": "消息详情", |
|
"usage": "查看后自动标记为已读。返回 data 为 UserMessage 对象,包含 id、msgType、title、content、bizId、createTime。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/message/detail/{id}", |
|
"operationId": "detailUsingGET_1", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "path", |
|
"required": true, |
|
"type": "integer / int64", |
|
"description": "消息ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "用户消息中心", |
|
"name": "分页查询我的消息列表", |
|
"usage": "返回 data 为 Page 分页对象。list 中每条记录为 UserMessage 对象,主要字段:id、userId-用户ID、msgType-消息类型(如points_award/hazard_audit/appeal_result)、title-消息标题、content-消息内容、bizId-关联业务ID、isRead-是否已读(0未读/1已读)、createTime-创建时间。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/message/list", |
|
"operationId": "listUsingGET_3", |
|
"parameters": [ |
|
{ |
|
"name": "msgType", |
|
"in": "query", |
|
"required": false, |
|
"type": "string", |
|
"description": "消息类型(可选)" |
|
}, |
|
{ |
|
"name": "onlyUnread", |
|
"in": "query", |
|
"required": false, |
|
"type": "boolean", |
|
"description": "是否只查未读" |
|
}, |
|
{ |
|
"name": "pageNum", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "页码" |
|
}, |
|
{ |
|
"name": "pageSize", |
|
"in": "query", |
|
"required": false, |
|
"type": "integer / int32", |
|
"description": "每页数量" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "用户消息中心", |
|
"name": "标记消息已读", |
|
"usage": "将指定消息标记为已读。返回 data 为 null,成功时 code=200。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/message/read/{id}", |
|
"operationId": "markReadUsingPOST", |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "path", |
|
"required": true, |
|
"type": "integer / int64", |
|
"description": "消息ID" |
|
} |
|
], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "用户消息中心", |
|
"name": "全部标记已读", |
|
"usage": "将当前用户所有未读消息标记为已读。返回 data 为 null,成功时 code=200。", |
|
"method": "POST", |
|
"path": "/gd_dataserver/gd_dataserver/business/message/readAll", |
|
"operationId": "markAllReadUsingPOST", |
|
"parameters": [], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "201", |
|
"description": "Created", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
}, |
|
{ |
|
"tag": "用户消息中心", |
|
"name": "获取未读消息数量", |
|
"usage": "返回 data 为 Long 类型的未读消息数量,如 5。用于APP端消息红点展示。", |
|
"method": "GET", |
|
"path": "/gd_dataserver/gd_dataserver/business/message/unread-count", |
|
"operationId": "unreadCountUsingGET", |
|
"parameters": [], |
|
"requestBodies": [], |
|
"responses": [ |
|
{ |
|
"status": "200", |
|
"description": "OK", |
|
"schemas": [ |
|
{ |
|
"contentType": "*/*", |
|
"schema": "object<string, object>" |
|
} |
|
] |
|
}, |
|
{ |
|
"status": "401", |
|
"description": "Unauthorized", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "403", |
|
"description": "Forbidden", |
|
"schemas": [] |
|
}, |
|
{ |
|
"status": "404", |
|
"description": "Not Found", |
|
"schemas": [] |
|
} |
|
] |
|
} |
|
] |