华为云用户手册

  • 风险分级管控 接口 说明 风险管控任务创建 查询风险清单 该接口用于查询风险清单。 创建风险管控任务 该接口用于创建风险管控任务。 风险管控任务资产创建 该接口控制6个定时任务是否启动,启动后,基于风险点、管控周期、管控岗位自动创建管控任务。 查询定时任务状态 该接口查询6个定时任务的状态。 风险管控任务执行 查询风险管控任务列表 该接口用于查询风险管控任务列表。 文件上传(文件不超过5MB) 该接口用于上传文件(小文件,文件大小不超过5MB)。 文件上传(文件大于5MB) 自定义接口请求体大小限制5MB,当上传的文件大小超过5MB时,需要通过分段上传的方式来实现文件的完整上传。 初始化大文件:该接口用于初始化大文件分段上传任务。 分片上传文件:该接口用于分片上传文件。 合并文件:该接口用于分片上传文件时,合并分片上传的文件。 任务执行 该接口用于执行风险管控任务。
  • 隐患排查治理 接口 说明 隐患录入 查询标准隐患列表 该接口用于查询标准隐患列表。 查询风险点列表 该接口用于查询风险点(即行政区域)列表。 查询辨识对象 该接口用于查询辨识对象(即作业对象)列表。 查询隐患扩展字段 该接口用于查询隐患扩展属性配置(检查类别、隐患专业、检查日期、整改类型、整改措施、整改资金、来源)。 隐患录入 该接口用于添加隐患。 隐患整改反馈 转派隐患处理人 该接口用于转派隐患给他人处理。 隐患进展反馈 该接口用于反馈隐患整改进展。 隐患验收 隐患验收 该接口用于验收隐患整改结果。
  • 请求参数 参数 类型 是否必填 描述 issueIdList String 是 需要转派的隐患id列表 issueHandlerId String 是 转派后的处理人id,多人使用‘;’间隔 issueHandlerName String 否 转派后的处理人名称,多人使用‘;’间隔 remark String 是 转派原因 operUserId String 否 操作人id 说明: 不传时默认从上下文获取。 todoUrlPC String 否 PC端待办页面地址,不传时默认双预控预置页面 todoUrlAPP String 否 APP端待办页面地址,不传时默认双预控预置页面
  • 响应消息体 响应消息体通常以结构化格式返回,与响应消息头中Content-type对应,传递除响应消息头之外的内容。 对于使用OAuth 2.0的客户端鉴权模式获取用户access_token接口,返回如下消息体。其中“access_token”是需要获取的用户Token,取值以变量“XXX”表示。有了Token之后,您可以使用access_token认证调用其他API。 { "access_token": "XXX", "expires_in": 1800, "token_type": "Bearer"} 当接口调用出错时,会返回错误码“400”及错误信息说明,错误响应的Body体格式如下所示。 { "error": "unauthorized_client", "error_description": "The client is not authorized to request a token using this method."} 其中,error表示错误提示,error_description表示错误描述信息。
  • 响应示例 { "resCode": "0", "resMsg": "成功", "result": { "result": [ { "affectedRows": 1, "creatorDescribe": "1234", "entityName": "taskIssue", "issueHandlerId": "391242", "issueHandlerName": "XXX", "issueHandlerSupplierName": "--", "issueId": 373332, "issueInstance": "1", "lastUpdateBy": 895404, "lastUpdateDate": "2023-05-22 20:18:50", "lastUpdateName": "appcubeAdapter", "lastUpdatedBy": 895404, "slaStatus": 1, "status": 2, "userGroup": null, "userGroupName": "" } ] }}
  • 响应参数 参数 类型 描述 resCode String 响应状态码 0:成功 其他:失败,其他错误码说明请参考错误码 resMsg String 响应描述,如果成功状态,通常会返回“成功”,其他情况返回具体的错误信息 result Object 响应结果内容 result参数说明 参数 类型 描述 jobObjectList Object 作业对象列表 totalCount Number 查询结果总数
  • 响应示例 { "resCode": "0", "resMsg": "成功", "result": { "jobObjectList": [ { "appName": "basedata-server", "childCount": 0, "city": null, "cityId": null, "coordinate": null, "country": null, "countryId": null, "createName": "XXX", "createdBy": 467935, "creationDate": "2022-10-25T09:18:04.000+00:00", "creationTimestamp": 1666689483286, "customerId": null, "customerName": null, "deleteFlag": 0, "deviceId": null, "deviceTypeId": null, "entityName": "taskObject", "geoHash": null, "groupName": "通用", "groupNamePathList": [ "通用" ], "groupPath": "3446", "groupPathName": "通用", "lastUpdateDate": "2022-10-25T09:18:04.000+00:00", "lastUpdateName": "XXX", "lastUpdateTimestamp": 1666689483286, "lastUpdatedBy": 467935, "latitude": "", "longitude": "", "mappingOrgId": null, "orgFlag": "0", "orgId": null, "orgPath": null, "ownerGroupId": null, "ownerGroupName": null, "ownerIds": "", "ownerNames": null, "positionSystem": "", "projectName": null, "projectNo": "", "province": null, "provinceId": null, "regionId": null, "regionPath": null, "secret": "0", "signSiteAddress": "", "signSiteCode": "作业对象44", "signSiteId": 99052390, "signSiteLevel": null, "signSiteName": "作业对象44", "signSiteParentId": null, "signSiteSource": "1", "signSiteType": "", "signSiteTypeCode": null, "supplierId": null, "supplierName": null, "taskObjectGroupId": 3446, "tenantId": 1745, "tenantName": null, "udfExtend1": null, "udfExtend10": null, "udfExtend2": null, "udfExtend3": null, "udfExtend4": null, "udfExtend5": null, "udfExtend6": null, "udfExtend7": null, "udfExtend8": null, "udfExtend9": null } ], "totalCount": 1 }}
  • 请求参数 参数 类型 是否必填 描述 isComplete String 是 是否完成隐患反馈 0:完成 1:不完成 issueId String 是 隐患id feedBack String 是 反馈内容 attachmentList Attachment 否 附件列表 说明: isComplete=1时支持上传附件,isComplete=0时不支持上传附件。 operUserId String 否 操作人id 说明: 不传时默认从上下文获取。 todoUrlPC String 否 PC端待办页面地址,不传时默认双预控预置页面 todoUrlAPP String 否 APP端待办页面地址,不传时默认双预控预置页面 attachmentList参数说明 参数 类型 是否必填 描述 fileId Number 否 文件id fileName String 否 文件名称
  • 请求示例 { "isComplete": "1", "issueId": "373330", "feedBack": "反馈内容", "attachmentList": [ { "fileId": 7566519, "fileName": "头像528k.jpg" } ], "operUserId": "391242"}
  • 请求参数 参数 类型 是否必填 描述 issueIdList String 是 需要验收的隐患id列表 remark String 是 验收描述 operate String 是 操作类型: 1:验收通过 2:驳回 attachmentList Attachment 否 附件列表 operUserId String 否 操作人id 说明: 不传时默认从上下文获取。 operUserName String 否 操作人名称 说明: 不传时默认从上下文获取。 todoUrlPC String 否 PC端待办页面地址,不传时默认双预控预置页面 todoUrlAPP String 否 APP端待办页面地址,不传时默认双预控预置页面 attachmentList参数说明 参数 类型 是否必填 描述 fileId Number 否 文件id fileName String 否 文件名称
  • 请求示例 { "issueIdList": ["373330"], "remark": "验收描述", "operate": "1", "attachmentList": [ { "fileId": 7565561, "fileName": "头像528k.jpg" } ], "operUserId": "391242", "operUserName": "XXX"}
  • 响应示例 { "resCode": "0", "resMsg": "成功", "result": { "result": [ { "affectedRows": 1, "closeBy": 895404, "closeDate": "2023-05-22T12:34:39.478+00:00", "closeName": "appcubeAdapter", "closeTimestamp": 1684758879478, "creatorDescribe": "123", "creatorResult": "验收描述", "entityName": "taskIssue", "issueId": 373330, "issueInstance": "1", "lastUpdateBy": 895404, "lastUpdateDate": "2023-05-22T12:34:39.478+00:00", "lastUpdateName": "appcubeAdapter", "lastUpdatedBy": 895404, "status": 4 } ] }}
  • 功能介绍 该接口控制6个定时任务是否启动,启动后,基于风险点、管控周期、管控岗位自动创建管控任务。 每班:autoCreateTaskForShift,首次执行时间:22:00:00(0-8点),周期:8小时 每天:autoCreateTaskForDay,首次执行时间:22:00:00,周期:1天 每周:autoCreateTaskForWeek,首次执行时间:周天22:00:00,周期:7天 每月:autoCreateTaskForMonth,首次执行时间:28日22:00:00,周期:1月 每季度:autoCreateTaskForQuarter,首次执行时间:12月28日22:00:00,周期:3月 每半年:autoCreateTaskForHalfyear,首次执行时间:12月28日22:00:00,周期:6月
  • 响应示例 { "resCode": "0", "resMsg": "成功", "result": { "riskIdentityList": [ { "checkItem": "", "consequenceValue": 40, "controllDiscipline": "", "controllPeriod": "", "createBy": "10gg000000vgy8jvpTlB", "createDate": "2023-05-23 15:11:13", "createdByName": "XXX", "exposureRate": 6, "facsNum": 1, "id": "cslU0000013VseOaeG7E", "identifyingObjects ": null, "index": 0, "jobObjectCode": "", "jobObjectId": null, "jobObjectName": "", "locationCode": "CN", "locationId": 187252, "locationName": "中国", "orgUnit": "XXXXXX", "possibilityRate": 6, "riskDesc": "cs0523-2", "riskFactor": "危险因素", "riskId": "", "riskLevel": "重大风险", "riskOrganUnitCode": "", "riskOrganUnitID": 35320, "riskRatingModelType": "", "riskStatus": 1, "riskType": "测试1", "riskValue": 1440, "solutionList": [ { "controlSource": "", "id": "cgSW0000013VseOpPOsa", "sectionClauses": "", "solutionDesc": "测试的长度啊" } ] } ], "total": 1 }}
  • 请求参数 参数 类型 是否必填 描述 pageStart Number 是 查询起始页 pageSize Number 是 查询条数,取值范围:1~100 riskDesc String 否 风险描述,模糊搜索 riskLevel String 否 风险等级,精确搜索 jobObjectCode String 否 辨识对象编码,精确搜索 jobObjectId Number 否 辨识对象id,精确搜索 jobObjectName String 否 辨识对象名称,模糊搜索 locationCode String 否 风险点编码,精确搜索 locationId Number 否 风险点id,精确搜索 locationName String 否 风险点名称,模糊搜索 controllDiscipline String 否 管控专业,精确搜索 solutionDesc String 否 管控措施描述,模糊搜索 sectionClauses String 否 管控周期,精确搜索 说明: 结果中每个风险下都只有对应管控周期的管控措施。 riskStatus Number 否 风险状态: 0:不启用 1:启用
  • 响应示例 { "resCode": "0", "resMsg": "成功", "result": { "issueInfo": { "acceptanceUserList": [ { "userId": 288762, "userType": 1 }, { "userId": 891419, "userType": 1 } ], "action": 1, "adminOrganization": "35320", "adminOrganizationName": "XXXXXX", "affectedRows": 1, "appName": "isdp-qc-server", "checkUserList": [ { "userId": 288762, "userType": 1 }, { "userId": 891419, "userType": 1 } ], "code": "Issue20230522178888", "createName": "XXX", "createdBy": 288762, "creationDate": "2023-05-22 17:11:52", "creationTimestamp": 1684746711412, "creatorDescribe": "cs0519-5", "deleteFlag": 0, "dueTimestamp": 1683907200000, "entityName": "taskIssue", "issueAttachmentList": [ { "fileId": 7566519, "fileName": "头像528k.jpg", "fileType": "jpg" } ], "issueAttributeModel": { "udf1": "采煤", "udf2": "每月检查", "udf3": "1683849600000", "udf4": "1", "udf5": "整改措施", "udf6": "11111", "udf7": "来源" }, "issueCarbonCopyList": [], "issueHandlerId": "288762;891419", "issueHandlerName": "XXX;XXX", "issueHandlerSupplierName": "--;--", "issueId": 373311, "issueInstance": "1", "issueItemId": "cuCe0000013Dhjcbmd6W", "issueLevel": 3, "issueRemark": null, "issueSource": "5", "issueType": "类别3#通风;", "issueTypeCode": "UDF8", "issueTypeFather": "类别3", "itemId": null, "itemName": null, "kcpId": null, "kcpName": null, "lastUpdateBy": 288762, "lastUpdateDate": "2023-05-22 17:11:52", "lastUpdateName": "XXX", "lastUpdatedBy": 288762, "operUserId": null, "operUserName": null, "orgPath": "-1.25245.35320", "problemPlanFinishDate": "2023-05-13", "regionId": 187252, "regionName": "中国", "regionPath": "187252", "riskList": [], "sceneTaskId": null, "signSiteCode": "shuNanj", "signSiteId": 99064876, "signSiteName": "shu南京华为门店", "slaStatus": 1, "status": 2, "submitPending": 0, "supervisedUserList": [ { "userId": 288762, "userType": 1 }, { "userId": 891419, "userType": 1 } ], "taskId": null, "templateId": null, "tenantId": 1745, "thirdUrl": "xxxxxx", "udf1": "采煤", "udf10": null, "udf11": null, "udf12": null, "udf13": null, "udf14": null, "udf15": null, "udf16": null, "udf17": null, "udf18": null, "udf19": null, "udf2": "每月检查", "udf20": null, "udf3": "1683849600000", "udf4": "1", "udf5": "整改措施", "udf6": "11111", "udf7": "来源", "udf8": null, "udf9": null, "url": "xxxxxx" } }}
  • 请求示例 { "action":1, "issueItemId":"cuCe0000013Dhjcbmd6W", "creatorDescribe":"cs0519-5", "issueLevel":3, "issueHandlerId":"288762;891419", "checkUserId":"288762;891419", "acceptanceUserId":"288762;891419", "supervisedUserId":"288762;891419", "regionId":"187252", "issueAttachmentList":[{ "fileId":7566519, "fileName":"头像528k.jpg" }], "signSiteId":99064876, "dueTimestamp":1683907200000, "issueTypeFather":"类别3", "issueType":"类别3#通风;", "checkCategory":"每月检查", "hiddenMajor":"采煤", "checkDate":"1683849600000", "rectificationType":"1", "rectificationSolution":"整改措施", "rectificationFunds":"11111", "resource":"来源", "submitterAccount":"XXXXXX@isdp", "todoUrlPC":"xxxxxx", "todoUrlAPP":"xxxxxx"}
  • 相关API 接口名称 调用说明 查询标准隐患列表 隐患录入时,需要输入关联的标准隐患id,调用该接口获取到关联的标准隐患id。 查询风险点列表 隐患录入时,需要输入风险点id,调用该接口获取到录入隐患时的风险点id。 查询辨识对象 隐患录入时,需要输入作业对象id(即辨识对象),调用该接口获取到录入隐患时的作业对象id。 查询隐患扩展字段 隐患录入时,需要输入隐患扩展字段,调用该接口获取到隐患扩展属性配置。
  • 请求参数 参数 类型 是否必填 描述 action Number 是 0:保存草稿 1:提交 issueItemId String 否 关联的标准隐患id creatorDescribe String 是 隐患描述 issueLevel Number 否 隐患级别: 3-重大隐患 4-一般隐患A 5-一般隐患B 6-一般隐患C issueHandlerId String 否 处理人id,多人使用‘;’间隔 说明: 不指定处理人时传空字符串或者不传。 checkUserId String 否 检查人id,多人使用‘;’间隔 acceptanceUserId String 否 验收人id,多人使用‘;’间隔 supervisedUserId String 否 监督人id,多人使用‘;’间隔 regionId String 否 风险点id issueAttachmentList Attachment 否 附件列表 signSiteId Number 否 作业对象id dueTimestamp Number 否 计划完成时间戳,毫秒 issueTypeFather String 否 隐患大类,格式示例:‘父类别1;父类别2’ issueType String 否 隐患小类,格式示例:‘父类别1#子类别1;父类别1#子类别2;父类别2’ checkCategory String 否 检查类别,隐患扩展字段枚举值,需要先查询枚举值范围 hiddenMajor String 否 隐患专业,隐患扩展字段枚举值,需要先查询枚举值范围 checkDate String 否 检查日期时间戳,毫秒 rectificationType String 否 整改类型: 1:限期整改 2:现场整改 rectificationSolution String 否 整改措施 rectificationFunds String 否 整改资金 resource String 否 来源 submitterAccount String 否 操作人账号,不传时默认从上下文获取 todoUrlPC String 否 PC端待办页面地址,不传时默认双预控预置页面 todoUrlAPP String 否 APP端待办页面地址,不传时默认双预控预置页面 issueAttachmentList参数说明 参数 类型 是否必填 描述 fileId Number 否 文件id fileName String 否 文件名称
  • 请求示例 { "locationId": "187252", "locationCode": "CN", "locationName": "中国", "planBeginDate": 1684392034841, "planEndDate": 1684564834841, "shifts": "早班", "controlType": "领导带班检查", "riskIdentityList": [ { "checkItem": "检查项目1", "consequenceValue": 40, "controllDiscipline": "管控岗位1", "controllPeriod": null, "createBy": "10gg000000vgy8jvpTmF", "createDate": "2022-11-24 17:36:39", "createdByName": "XXXXXX", "exposureRate": 10, "facsNum": 2, "id": "cslU000000yhILG5V4gi", "identifyingObjects ": null, "index": 3, "jobObjectCode": "", "jobObjectId": null, "jobObjectName": "", "locationCode": null, "locationId": null, "locationName": null, "orgUnit": "值班室", "possibilityRate": 1, "riskDesc": "测试检查单引入风险问题", "riskFactor": "危险因素", "riskId": "", "riskLevel": "重大风险", "riskOrganUnitCode": "", "riskOrganUnitID": 35329, "riskRatingModelType": null, "riskStatus": 0, "riskType": "测试1", "riskValue": 400, "solutionList": [ { "controlSource": "测试租户", "id": "cgSW000000yhILG6dTCy", "sectionClauses": "每天", "solutionDesc": "1.事故发生后,事故现场人员立即汇报作业区说明地点、人员伤亡情况。2、安排专人接救护车。3、实行应急预案措施进行救治。4、保护好事故现场,必要时在事故现场周围建立警戒区域,现场紧急疏散,人员清点,传达紧急信息,事故调查等。5、报告电话:********;急救:120。" }, { "controlSource": "测试租户", "id": "cgSW000000yhILGDjRSa", "sectionClauses": "每天", "solutionDesc": "每年由矿特种设备管理人员负责联系鞍山市特种设备检验机构对电梯检验保证安全装置齐全有效;" } ] }, { "checkItem": "采煤工作面", "consequenceValue": 0, "controllDiscipline": "采煤", "controllPeriod": "", "createBy": "10gg000000vgy8jvpTlB", "createDate": "2023-05-16 14:19:13", "createdByName": "nara", "exposureRate": 0, "facsNum": 7, "id": "cslU0000013KCbh7XgCe", "identifyingObjects ": null, "index": 0, "jobObjectCode": null, "jobObjectId": null, "jobObjectName": null, "locationCode": "CN", "locationId": 187252, "locationName": "中国", "orgUnit": "皮带运输队", "possibilityRate": 0, "riskDesc": "XX0516-2", "riskFactor": "可能,但不经常", "riskId": "", "riskLevel": "低风险", "riskOrganUnitCode": null, "riskOrganUnitID": 35320, "riskRatingModelType": "LEC", "riskStatus": 0, "riskType": "瓦斯", "riskValue": 0, "solutionList": [ { "controlSource": "综采队", "id": "cgSW0000013KCbhN9cMC", "sectionClauses": "每天", "solutionDesc": "XX111XX222" }, { "controlSource": "综采队", "id": "cgSW0000013KCbhekkQC", "sectionClauses": "每天", "solutionDesc": "XX112" }, { "controlSource": "综采队", "id": "cgSW0000013KCbhh1XSi", "sectionClauses": "每天", "solutionDesc": "XX113" }, { "controlSource": "综采队", "id": "cgSW0000013KCbhj0jNA", "sectionClauses": "每天", "solutionDesc": "XX114" } ] } ], "adminOrganizationName": "测试租户", "adminOrganizationCode": 25245, "userId": "10gg000000xAaVtxKetU"}
  • 响应示例 { "resCode": "0", "resMsg": "成功", "result": { "taskId": 3284601, "taskName": "GKRW1684727505209", "taskSceneName": "GKCJ1684727503676", "templateName": "FXJCD1684727501031" }}
  • 响应参数 参数 类型 描述 resCode String 响应状态码 0:成功 其他:失败,其他错误码说明请参考错误码 resMsg String 响应描述,如果成功状态,通常会返回“成功”,其他情况返回具体的错误信息 result Object 响应结果内容 result参数说明 参数 类型 描述 taskId Number 任务id taskName String 任务名称 taskSceneName String 任务场景名称 templateName String 检查单模板名称
  • 请求参数 参数 类型 是否必填 描述 templateName String 否 检查单模板名称,自动生成规则:FXJCD+时间戳 locationId String 是 风险点id locationCode String 是 风险点编码 locationName String 是 风险点名称 riskIdentityList Object 是 辨识风险列表 controlSceneName String 否 管控场景名称,自动生成规则:GKCJ+时间戳 adminOrganizationName String 是 组织名称 adminOrganizationCode Number 是 组织id sceneRemark String 否 场景描述 controlTaskName String 否 管控任务名称,自动生成规则:GKRW+时间戳 taskBasicAttribute TaskBasicField 否 管控任务基础属性 planBeginDate Number 否 计划开始时间,毫秒级 planEndDate Number 否 计划结束时间,毫秒级 shifts String 否 班次 controlType String 否 管控类型 todoUrlPC String 否 PC端待办页面地址,不传时默认双预控预置页面 todoUrlAPP String 否 APP端待办页面地址,不传时默认双预控预置页面 taskExtendFieldList TaskExtendField 否 任务扩展属性列表,需要系统中存在该扩展属性 userId String 否 用户id,输入后替换上下文用户id taskExtendFieldList参数说明 参数 类型 是否必填 描述 fieldName String 否 扩展属性名称 extendValue String 否 扩展属性值 taskBasicAttribute参数说明 参数 类型 是否必填 描述 signSiteId Number 否 作业对象ID signSiteName String 否 作业对象名称 signSiteCode String 否 作业对象编码 administrativeDivisionName String 否 行政区域 address String 否 任务地址 projectName String 否 项目名称 projectNo String 否 项目编码 supplierName String 否 供应商 customerId Number 否 客户ID customerName String 否 客户名称 jobDuration String 否 标准作业时长 projectDuration String 否 工期 requiredStartTime Number 否 要求开始时间 requiredEndTime Number 否 要求完成时间 skill String 否 要求技能 schedulingMode String 否 调度模式 taskDescription String 否 任务描述 ccPersonType Number 否 抄送人员类型: 4:单个人员 6:群组 ccPerson String 否 抄送人员名称,单个人员账号或群组名称 ownerType Number 否 责任人员类型: 5:单个人员 7:群组 owner String 否 责任人员名称,单个人员账号或群组名称 FileItem参数说明 参数 类型 是否必填 描述 fileId Number 否 文件id fileName String 否 文件名称 fileType String 否 文件类型 fileSize Number 否 文件大小
  • 状态码 状态码如表1所示。 表1 状态码 状态码 编码 状态码说明 100 Continue 继续请求。 这个临时响应用来通知客户端,它的部分请求已经被服务器接收,且仍未被拒绝。 101 Switching Protocols 切换协议。只能切换到更高级的协议。 例如,切换到HTTP的新版本协议。 200 ok 请求成功。 201 Created 创建类的请求完全成功。 202 Accepted 已经接受请求,但未处理完成。 203 Non-Authoritative Information 非授权信息,请求成功。 204 NoContent 请求完全成功,同时HTTP响应不包含响应体。 在响应OPTIONS方法的HTTP请求时返回此状态码。 205 Reset Content 重置内容,服务器处理成功。 206 Partial Content 服务器成功处理了部分GET请求。 300 Multiple Choices 多种选择。请求的资源可包括多个位置,相应可返回一个资源特征与地址的列表用于用户终端(例如:浏览器)选择。 301 Moved Permanently 永久移动,请求的资源已被永久的移动到新的URI,返回信息会包括新的URI。 302 Found 资源被临时移动。 303 See Other 查看其它地址。 使用GET和POST请求查看。 304 Not Modified 所请求的资源未修改,服务器返回此状态码时,不会返回任何资源。 305 Use Proxy 所请求的资源必须通过代理访问。 306 Unused 已经被废弃的HTTP状态码。 400 BadRequest 非法请求。 建议直接修改该请求,不要重试该请求。 401 Unauthorized 在客户端提供认证信息后,返回该状态码,表明服务端指出客户端所提供的认证信息不正确或非法。 402 Payment Required 保留请求。 403 Forbidden 请求被拒绝访问。 返回该状态码,表明请求能够到达服务端,且服务端能够理解用户请求,但是拒绝做更多的事情,因为该请求被设置为拒绝访问,建议直接修改该请求,不要重试该请求。 404 NotFound 所请求的资源不存在。 建议直接修改该请求,不要重试该请求。 405 MethodNotAllowed 请求中带有该资源不支持的方法。 建议直接修改该请求,不要重试该请求。 406 Not Acceptable 服务器无法根据客户端请求的内容特性完成请求。 407 Proxy Authentication Required 请求要求代理的身份认证,与401类似,但请求者应当使用代理进行授权。 408 Request Time-out 服务器等候请求时发生超时。 客户端可以随时再次提交该请求而无需进行任何更改。 409 Conflict 服务器在完成请求时发生冲突。 返回该状态码,表明客户端尝试创建的资源已经存在,或者由于冲突请求的更新操作不能被完成。 410 Gone 客户端请求的资源已经不存在。 返回该状态码,表明请求的资源已被永久删除。 411 Length Required 服务器无法处理客户端发送的不带Content-Length的请求信息。 412 Precondition Failed 未满足前提条件,服务器未满足请求者在请求中设置的其中一个前提条件。 413 Request Entity Too Large 由于请求的实体过大,服务器无法处理,因此拒绝请求。为防止客户端的连续请求,服务器可能会关闭连接。如果只是服务器暂时无法处理,则会包含一个Retry-After的响应信息。 414 Request-URI Too Large 请求的URI过长(URI通常为网址),服务器无法处理。 415 Unsupported Media Type 服务器无法处理请求附带的媒体格式。 416 Requested range not satisfiable 客户端请求的范围无效。 417 Expectation Failed 服务器无法满足Expect的请求头信息。 422 UnprocessableEntity 请求格式正确,但是由于含有语义错误,无法响应。 429 TooManyRequests 表明请求超出了客户端访问频率的限制或者服务端接收到多于它能处理的请求。建议客户端读取相应的Retry-After首部,然后等待该首部指出的时间后再重试。 500 InternalServerError 表明服务端能被请求访问到,但是不能理解用户的请求。 501 Not Implemented 服务器不支持请求的功能,无法完成请求。 502 Bad Gateway 充当网关或代理的服务器,从远端服务器接收到了一个无效的请求。 503 ServiceUnavailable 被请求的服务无效。 建议直接修改该请求,不要重试该请求。 504 ServerTimeout 请求在给定的时间内无法完成。客户端仅在为请求指定超时(Timeout)参数时会得到该响应。 505 HTTP Version not supported 服务器不支持请求的HTTP协议的版本,无法完成处理。
  • 响应参数 参数 类型 描述 resCode String 响应状态码 0:成功 其他:失败,其他错误码说明请参考错误码 resMsg String 响应描述,如果成功状态,通常会返回“成功”,其他情况返回具体的错误信息 result Object 响应结果内容 result参数说明 参数 类型 描述 hiddenTroubleList Object 隐患列表 totalCount Number 查询结果总数
  • 请求参数 参数 类型 是否必填 描述 pageStart Number 是 查询起始页 pageSize Number 是 查询条数,取值范围:1~200 queryType String 是 查询类型: 0:全部 1:草稿 2:整改中(处理中) 3:验收中(待关闭) 4:已完成(已关闭) 5:待处理 说明: 多个类型用英文逗号分隔。 creatorDescribe String 否 隐患描述,模糊搜索 issueTypeFather String 否 隐患大类,模糊搜索 issueType String 否 隐患小类,模糊搜索 issueLevel Number 否 隐患等级: 3:重大隐患 4:一般隐患A 5:一般隐患B 6:一般隐患C issueHandlerName String 否 处理人名称,模糊搜索 createdBy String 否 创建人id adminOrganization String 否 组织id列表,例如:["35320","335329"] signSiteId String 否 辨识对象id
  • 响应示例 { "resCode": "0", "resMsg": "成功", "result": { "hiddenTroubleList": [ { "accountableParty": null, "adminOrganization": "35320", "adminOrganizationName": "皮带运输队", "adminRegion": null, "adminRegionName": null, "checkSceneTaskId": null, "city": null, "closeBy": 895404, "closeDate": "2023-05-18 17:12:07", "closeName": "appcubeAdapter", "closeTimestamp": 1684401127963, "code": "Issue20230512154380", "country": null, "createName": "nara", "createSupplierName": null, "createdBy": 288762, "createdByUserInfo": "[{\"personId\":288204,\"personGroupId\":null,\"blackList\":0,\"reason\":null,\"profilePictureStatus\":\"CollectionSucceeded\",\"profilePictureId\":\"7492680\",\"personCode\":\"100035@isdp\",\"firstName\":null,\"lastName\":null,\"personName\":\"nara\",\"qualificationCode\":null,\"personType\":\"Admin\",\"tenantId\":1745,\"certificateType\":null,\"certificateNo\":null,\"description\":null,\"phone\":\"131******86\",\"adminOrgId\":35320,\"headFileId\":7492679,\"orgName\":\"皮带运输队\",\"customerId\":null,\"customerName\":null,\"supplierId\":null,\"supplierName\":null,\"openAccount\":null,\"account\":null,\"faceFileId\":null,\"integrationAccount\":null,\"status\":0,\"lastUpdatedBy\":288762,\"lastUpdateDate\":\"2023-04-19T07:22:05.000+00:00\",\"personStatus\":\"OpenAccount\",\"udfExtend1\":null,\"udfExtend2\":null,\"udfExtend3\":null,\"udfExtend4\":null,\"udfExtend5\":null,\"udfExtend6\":null,\"udfExtend7\":null,\"udfExtend8\":null,\"udfExtend9\":null,\"udfExtend10\":null,\"isSmartDevice\":\"N\",\"userId\":288762,\"qualificationList\":[{\"personQualId\":76572,\"personQualPictureId\":\"\",\"personQualPictureStatus\":null,\"personQualCode\":\"First aid\",\"personQualName\":\"急救证\",\"validPeriod\":\"12天\",\"skillId\":96367,\"startDate\":\"2021-04-18\",\"endDate\":\"2021-04-30\",\"creationDate\":\"2021-04-25T11:12:47.000+00:00\",\"skillLevelCode\":\"DJ202106001\",\"skillLevelName\":\"1级\",\"skillCode\":\"First aid\",\"skillName\":\"急救证\",\"skillDomainCode\":\"LY202106001\",\"skillDomainName\":\"安全\",\"personId\":288204,\"qualStatus\":\"false\"},{\"personQualId\":470168,\"personQualPictureId\":\"\",\"personQualPictureStatus\":null,\"personQualCode\":\"General EHS\",\"personQualName\":\"EHS通用\",\"validPeriod\":\"6_days\",\"skillId\":96369,\"startDate\":\"2023-02-22\",\"endDate\":\"2023-02-28\",\"creationDate\":\"2023-02-22T03:47:46.000+00:00\",\"skillLevelCode\":\"DJ202106001\",\"skillLevelName\":\"1级\",\"skillCode\":\"General EHS\",\"skillName\":\"EHS通用\",\"skillDomainCode\":\"LY202106001\",\"skillDomainName\":\"安全\",\"personId\":288204,\"qualStatus\":\"false\"}],\"qualificationName\":\"急救证;EHS通用\",\"personPositionList\":[{\"personId\":288204,\"positionId\":103783,\"positionCode\":\"aaa\",\"positionName\":\"aaa\",\"orgId\":25245,\"orgNo\":\"SaasTenant1745\",\"orgName\":\"信息展示子系统SIT测试租户\",\"positionFactor\":\"1.00\"},{\"personId\":288204,\"positionId\":103784,\"positionCode\":\"111\",\"positionName\":\"aaa\",\"orgId\":32962,\"orgNo\":\"SIT一级组织2\",\"orgName\":\"SIT一级组织2\",\"positionFactor\":\"1.00\"},{\"personId\":288204,\"positionId\":102758,\"positionCode\":\"123\",\"positionName\":\"123\",\"orgId\":25245,\"orgNo\":\"SaasTenant1745\",\"orgName\":\"信息展示子系统SIT测试租户\",\"positionFactor\":\"1.00\"},{\"personId\":288204,\"positionId\":102759,\"positionCode\":\"发斯蒂芬\",\"positionName\":\"发电房\",\"orgId\":25245,\"orgNo\":\"SaasTenant1745\",\"orgName\":\"信息展示子系统SIT测试租户\",\"positionFactor\":\"1.00\"},{\"personId\":288204,\"positionId\":12927,\"positionCode\":\"1\",\"positionName\":\"大佬\",\"orgId\":25245,\"orgNo\":\"SaasTenant1745\",\"orgName\":\"信息展示子系统SIT测试租户\",\"positionFactor\":\"1.00\"}],\"PersonPositionNameStr\":\"aaa;aaa;123;发电房;大佬\",\"personPositionCodeStr\":\"aaa;111;123;发斯蒂芬;1\"}]", "creationTimestamp": 1683878123313, "creatorDescribe": "隐患描述cs0512-8", "creatorResult": "验收通过", "creatorWorkUnit": null, "dealDate": "2023-05-18 15:24:20", "dealTimestamp": 1684394660247, "deleteFlag": 0, "department": null, "departmentName": null, "dueTimestamp": 1683907200000, "ehsViolatorId": null, "ehsViolatorName": null, "handlerFeedback": null, "issueAttachmentList": [ { "appName": "isdp-qc-server", "createName": "nara", "createdBy": 288762, "creationDate": "2023-05-12 15:55:24", "creationTimestamp": 1683878124400, "deleteFlag": 0, "entityName": "IssueAttachment", "fileId": 7565319, "fileName": "附件一.PNG", "fileSource": 1, "fileType": "png", "id": 75284, "issueId": 351430, "lastUpdateDate": "2023-05-12 15:55:24", "lastUpdateName": "nara", "lastUpdateTimestamp": 1683878124400, "lastUpdatedBy": 288762, "tenantId": 1745, "thumbnailsId": null, "waterMarkInfo": null, "waterMarkKey": null } ], "issueHandlerId": "288762", "issueHandlerName": "nara", "issueHandlerSupplierName": "--", "issueHandlerUserInfo": "[{\"personId\":288204,\"personGroupId\":null,\"blackList\":0,\"reason\":null,\"profilePictureStatus\":\"CollectionSucceeded\",\"profilePictureId\":\"7492680\",\"personCode\":\"100035@isdp\",\"firstName\":null,\"lastName\":null,\"personName\":\"nara\",\"qualificationCode\":null,\"personType\":\"Admin\",\"tenantId\":1745,\"certificateType\":null,\"certificateNo\":null,\"description\":null,\"phone\":\"131******86\",\"adminOrgId\":35320,\"headFileId\":7492679,\"orgName\":\"皮带运输队\",\"customerId\":null,\"customerName\":null,\"supplierId\":null,\"supplierName\":null,\"openAccount\":null,\"account\":null,\"faceFileId\":null,\"integrationAccount\":null,\"status\":0,\"lastUpdatedBy\":288762,\"lastUpdateDate\":\"2023-04-19T07:22:05.000+00:00\",\"personStatus\":\"OpenAccount\",\"udfExtend1\":null,\"udfExtend2\":null,\"udfExtend3\":null,\"udfExtend4\":null,\"udfExtend5\":null,\"udfExtend6\":null,\"udfExtend7\":null,\"udfExtend8\":null,\"udfExtend9\":null,\"udfExtend10\":null,\"isSmartDevice\":\"N\",\"userId\":288762,\"qualificationList\":[{\"personQualId\":76572,\"personQualPictureId\":\"\",\"personQualPictureStatus\":null,\"personQualCode\":\"First aid\",\"personQualName\":\"急救证\",\"validPeriod\":\"12天\",\"skillId\":96367,\"startDate\":\"2021-04-18\",\"endDate\":\"2021-04-30\",\"creationDate\":\"2021-04-25T11:12:47.000+00:00\",\"skillLevelCode\":\"DJ202106001\",\"skillLevelName\":\"1级\",\"skillCode\":\"First aid\",\"skillName\":\"急救证\",\"skillDomainCode\":\"LY202106001\",\"skillDomainName\":\"安全\",\"personId\":288204,\"qualStatus\":\"false\"},{\"personQualId\":470168,\"personQualPictureId\":\"\",\"personQualPictureStatus\":null,\"personQualCode\":\"General EHS\",\"personQualName\":\"EHS通用\",\"validPeriod\":\"6_days\",\"skillId\":96369,\"startDate\":\"2023-02-22\",\"endDate\":\"2023-02-28\",\"creationDate\":\"2023-02-22T03:47:46.000+00:00\",\"skillLevelCode\":\"DJ202106001\",\"skillLevelName\":\"1级\",\"skillCode\":\"General EHS\",\"skillName\":\"EHS通用\",\"skillDomainCode\":\"LY202106001\",\"skillDomainName\":\"安全\",\"personId\":288204,\"qualStatus\":\"false\"}],\"qualificationName\":\"急救证;EHS通用\",\"personPositionList\":[{\"personId\":288204,\"positionId\":103783,\"positionCode\":\"aaa\",\"positionName\":\"aaa\",\"orgId\":25245,\"orgNo\":\"SaasTenant1745\",\"orgName\":\"信息展示子系统SIT测试租户\",\"positionFactor\":\"1.00\"},{\"personId\":288204,\"positionId\":103784,\"positionCode\":\"111\",\"positionName\":\"aaa\",\"orgId\":32962,\"orgNo\":\"SIT一级组织2\",\"orgName\":\"SIT一级组织2\",\"positionFactor\":\"1.00\"},{\"personId\":288204,\"positionId\":102758,\"positionCode\":\"123\",\"positionName\":\"123\",\"orgId\":25245,\"orgNo\":\"SaasTenant1745\",\"orgName\":\"信息展示子系统SIT测试租户\",\"positionFactor\":\"1.00\"},{\"personId\":288204,\"positionId\":102759,\"positionCode\":\"发斯蒂芬\",\"positionName\":\"发电房\",\"orgId\":25245,\"orgNo\":\"SaasTenant1745\",\"orgName\":\"信息展示子系统SIT测试租户\",\"positionFactor\":\"1.00\"},{\"personId\":288204,\"positionId\":12927,\"positionCode\":\"1\",\"positionName\":\"大佬\",\"orgId\":25245,\"orgNo\":\"SaasTenant1745\",\"orgName\":\"信息展示子系统SIT测试租户\",\"positionFactor\":\"1.00\"}],\"PersonPositionNameStr\":\"aaa;aaa;123;发电房;大佬\",\"personPositionCodeStr\":\"aaa;111;123;发斯蒂芬;1\"}]", "issueId": 351430, "issueInstance": "1", "issueItemId": "", "issueKind": null, "issueLevel": 4, "issueRemark": null, "issueSource": "5", "issueType": "类别3#通风;", "issueTypeCode": "UDF8", "issueTypeFather": "类别3", "itemId": null, "itemName": null, "kcpId": null, "kcpName": null, "lastUpdateDate": "2023-05-18 17:12:07", "lastUpdateName": "appcubeAdapter", "lastUpdateTimestamp": 1684401127000, "lastUpdatedBy": 895404, "liveId": null, "projectNo": null, "province": null, "region": null, "regionId": null, "regionName": null, "regionPath": null, "relationSceneTaskName": "", "riskList": [], "sceneTaskId": null, "sceneTaskName": null, "signSiteCode": "新建位置对象", "signSiteId": 99054145, "signSiteName": "新建位置对象", "slaStatus": 1, "sourceType": null, "standardTroubleInfo": {}, "status": 4, "submitPending": 0, "taskBusiType": null, "taskId": null, "taskName": null, "taskSheetType": null, "taskType": null, "templateId": null, "tenantId": 1745, "udf1": "采煤", "udf10": null, "udf10Close": null, "udf10Deal": null, "udf11": null, "udf11Close": null, "udf11Deal": null, "udf12": null, "udf12Close": null, "udf12Deal": null, "udf13": null, "udf13Close": null, "udf13Deal": null, "udf14": null, "udf14Close": null, "udf14Deal": null, "udf15": null, "udf15Close": null, "udf15Deal": null, "udf16": null, "udf16Close": null, "udf16Deal": null, "udf17": null, "udf17Close": null, "udf17Deal": null, "udf18": null, "udf18Close": null, "udf18Deal": null, "udf19": null, "udf19Close": null, "udf19Deal": null, "udf1Close": null, "udf1Deal": null, "udf2": "每月检查", "udf20": null, "udf20Close": null, "udf20Deal": null, "udf2Close": null, "udf2Deal": null, "udf3": "1683849600000", "udf3Close": null, "udf3Deal": null, "udf4": "1", "udf4Close": null, "udf4Deal": null, "udf5": "整改措施", "udf5Close": null, "udf5Deal": null, "udf6": "111111", "udf6Close": null, "udf6Deal": null, "udf7": null, "udf7Close": null, "udf7Deal": null, "udf8": null, "udf8Close": null, "udf8Deal": null, "udf9": null, "udf9Close": null, "udf9Deal": null, "userGroup": null, "userGroupName": null } ], "totalCount": 1 }}
  • 请求示例 { "pageStart": 0, "pageSize": 15, "queryType": "4", "creatorDescribe": "描述", "issueTypeFather": "类别", "issueType": "通风", "issueLevel": 4, "issueHandlerName": "nara", "createdBy": "288762", "adminOrganization": [ "35320", "335329" ], "signSiteId": "99054145"}
  • 请求示例 { "ifComplete": 1, "checkOrderId": 6104785, "templateId": 311834, "kcpList": [ { "kcpId": 437004, "children": [ { "itemId": 3572895, "textDataList": [ { "outputId": 43946162, "contentType": 4, "content": "落实" }, { "outputId": 43946163, "contentType": 20, "content": "备注zhengchang222666" } ] }, { "itemId": 3572896, "textDataList": [ { "outputId": 43946165, "contentType": 4, "content": "落实" }, { "outputId": 43946166, "contentType": 20, "content": "备注zhengchang22777" } ] } ] }, { "kcpId": 437005, "children": [ { "itemId": 3572897, "textDataList": [ { "outputId": 43946168, "contentType": 4, "content": "不涉及" }, { "outputId": 43946169, "contentType": 20, "content": "备注zhengchang233888" } ] }, { "itemId": 3572898, "textDataList": [ { "outputId": 43946171, "contentType": 4, "content": "不涉及" }, { "outputId": 43946172, "contentType": 20, "content": "备注zhengchang2111999" } ] }, { "itemId": 3572899, "textDataList": [ { "outputId": 43946174, "contentType": 4, "content": "不涉及" }, { "outputId": 43946175, "contentType": 20, "content": "备注zhengchang233888" } ] }, { "itemId": 3572900, "textDataList": [ { "outputId": 43946177, "contentType": 4, "content": "不涉及" }, { "outputId": 43946178, "contentType": 20, "content": "备注zhengchang233888" } ] } ] } ], "userId": "10gg000000xAaVtxKetU"}
  • 请求参数 参数 类型 是否必填 描述 ifComplete Number 是 是否完成任务: 0:保存检查单采集数据 1:完成采集任务 checkOrderId Number 是 检查单id templateId Number 是 检查单模板id kcpList Kcp 否 KCP列表 说明: ifComplete=0时必填,ifComplete=1时不填。 userId String 否 用户id,输入后替换上下文用户id kcpList参数说明 参数 类型 是否必填 描述 kcpId Number 否 KCP id children Item 否 Item列表 children参数说明 参数 类型 是否必填 描述 itemId Number 否 item id textDataList TextData 否 文本输出项列表 fileList File 否 文件输出项列表 textDataList参数说明 参数 类型 是否必填 描述 outputId Number 否 输出项id contentType Number 否 输出项类型 content String 否 输出项的值 fileList参数说明 参数 类型 是否必填 描述 outputId Number 否 输出项id contentType Number 否 输出项类型 fileId Number 否 输出项文件id fileName String 否 输出项文件名称
共100000条