华为云用户手册

请求示例 { "page": { "count": 20, "start": 0 }, "positionIds": [ 5000829, 5000830 ], "positionCode": [ "HWtest" ], "positionName": "测试", "idList": [ 5001610, 5001609 ], "personCodeList": [ "h00799695b", "h00799695a" ], "personName": null, "personType": "Employee;Customer", "orgIdList": [ 9911292880 ], "orgIncludeChild": false, "orgNoList": [ "SaasTenant101075" ], "orgName": "1551", "profilePictureStatus": "CollectionFailed", "phone": "13572003278", "personStatus": "NoAccountOpened;OpenAccount", "isSmartDevice": "N", "roleName": "现场作业人员;项目助理/后台人员", "roleNo": [ "ConstructionSiteOperator", "ConstructionProjectAssistant" ], "roleId": [ 126290, 126294 ] }

响应示例 { "data": [ { "personId": 5001610, "profilePictureStatus": "CollectionFailed", "personCode": "h00799695b", "personName": "黄xxtest2", "qualificationCode": null, "personType": "Employee", "tenantId": 101075, "certificateType": "", "certificateNo": null, "profilePictureId": "", "blackList": 0, "reason": null, "phone": "135******78", "adminOrgId": 9911292880, "integrationAccount": "", "lastUpdatedBy": 36378, "lastUpdateDate": "2023-08-11T14:23:09.000+08:00", "personStatus": "NoAccountOpened", "udfExtend1": null, "udfExtend2": null, "udfExtend3": null, "udfExtend4": null, "udfExtend7": null, "udfExtend8": null, "udfExtend9": null, "udfExtend10": null, "isSmartDevice": "N", "userId": 5003069, "Org": { "id": 9911292880, "orgId": 9911292880, "value": "15512345678aaa", "orgName": "15512345678aaa", "orgNo": "SaasTenant101075" }, "positionInfo": [ { "positionName": "测试", "positionId": "5000829", "positionCode": "HWtest" } ], "roleInfo": [ { "roleId": "126290", "roleCode": "ConstructionSiteOperator", "roleName": "现场作业人员" }, { "roleId": "126294", "roleCode": "ConstructionProjectAssistant", "roleName": "项目助理/后台人员" } ] } ], "pos": 0, "total_count": 1, "entityName": null, "totalCount": 1 }

请求示例 { "personCode": "test0727", "personName": "test0727", "personType": "Employee", "phone": "13822150727", "activeFlag": "Y", "qualificationCode": "68,69", "certificateNo": "440155200006019874", "password": "07******", "certificateType": "ID_CARD", "extPerson": { "gender": "female", "nation": "cn" }, "qualificationList": [ { "skillName": "急救证", "skillLevelName": "1级", "skillDomainName": "安全", "hireStatus": 1 } ], "personPositionList": [ { "positionId": "5000804" } ] }

文档更新记录 新增添加菜单（API名称：menu/addMenu） 2024/04/07 新增查询下级菜单信息（API名称：findLowerLevelMenu） 2024/04/07 新增查询任务的拓展属性列表（API名称：findTaskExtendAttributeList） 2024/04/07 新增查询检查单模板及KCP（API名称：openTask/queryKcpModeByTemplateId） 2024/04/07 新增智能检查结果（API名称：openIntelligentResult/queryOpenPhotoResultList） 2024/04/07 新增使用组织单元id查询岗位列表（API名称：findPositionListByOrgId） 2024/04/07 新增确认消息消费状态（API名称：confirmOpenMessage） 2024/04/07 新增根据UserId查询消息（API名称：findPagedMessageListByUserId） 2024/04/07 新增查询门店合格数排名（API名称：queryStoreScoreRank） 2024/04/07 新增查询item合格门店数排名（API名称：queryItemQualifiedStoreRank） 2024/04/07 新增查询kcp扣分占比（API名称：queryKcpDeductPointRatio） 2024/04/07 新增查询门店/人员巡检次数排名（API名称：queryInspectTimesRank） 2024/04/07 新增查询巡检得分（API名称：queryHWRetailTaskScore） 2024/04/07 新增查询巡检覆盖率（API名称：queryInspectCoverageRate） 2024/04/07 新增查询问题闭环率（API名称：queryIssueCloseRate） 2024/04/07 更新分页查询岗位信息（API名称：findPagedPosition） 2024/02/27 新增查询不合格条目问题（API名称：queryUnqualifiedItemList） 2024/02/18 新增查询组织信息（API名称：getOrgData） 2024/02/18 新增查询岗位信息(API名称：getPositionData) 2024/02/18 新增查询用户角色（API名称：findRolePage） 2024/02/18 新增查询巡检场景列表（API名称：queryInspectSceneList） 2024/02/18 新增查询任务场景信息（API名称：getTaskSceneData） 2024/02/18 新增批量新增岗位角色权限（API名称：batchSavePositionRoleGrant） 2024/02/18 新增批量取消岗位角色权限（API名称：batchDeletePositionRoleGrant） 2024/02/18 新增分页查询组织信息（API名称：findPagedOrgList） 2024/02/18 新增批量查询组织信息（API名称：batchOrgInfoByOrgNoAndOrgName） 2024/02/18 新增查询指定场景的历史版本（API名称：openTaskScene/querySceneHisList） 2024/02/18 新增根据扩展字段查询任务列表（API名称：openTaskScene/queryTaskComponent） 2024/02/18 新增获取指定时间区间的派工人数（API名称：queryPeopleCount） 2024/02/18 新增通过id查询模板详情（API名称：querySceneById） 2024/02/18 新增查询子任务场景列表（API名称：openTaskScene/querySubTaskList） 2024/02/18 新增获取指定时间区间的积分总数（API名称：queryBonusByOnlyType） 2024/02/18 新增根据人员分组编码查询（API名称：personGroup/findByPersonGroupCode） 2024/02/17 新增添加人员账号（API名称：person/batchUpdatePerson） 2024/02/17 新增批量删除岗位（API名称：position/batchDeletePosition） 2024/02/17 新增批量取消人员岗位（API名称：person/batchDeletePersonPosition） 2024/02/17 新增批量新增人员岗位（API名称：person/batchSavePersonPosition） 2024/02/17 新增查询许可报告（API名称：openSceneTask/queryWorkTicketDocTemplates） 2024/02/17 新增查询许可阶段明细（API名称：openSceneTask/findWorkTicketPhaseDetail） 2024/02/17 新增查询许可阶段状态列表（API名称：openSceneTask/getLicenseStatusList） 2024/02/17 新增查询许可列表（API名称：openSceneTask/queryTicketPageList） 2024/02/17 新增修改许可单（API名称：openSceneTask/updateWorkTicket） 2024/02/17 新增审批许可单（API名称：openSceneTask/auditTicketPhase） 2024/02/17 新增转派班组、质检人员、责任人（API名称：batchReassignmentTask） 2024/02/17 新增查询任务详情（API名称：openTaskScene/queryTaskInfo） 2024/02/17 新增任务批量撤回（API名称：openSceneTask/batchRevokeTask） 2024/02/17 新增查询场景明细（API名称：openSceneTask/getLicenseSceneConfigInfo） 2024/02/17 新增领域场景查询（API名称：openTaskScene/queryTaskCategory） 2024/02/17 新增openApi创建问题类别配置（API名称：openSceneTask/openApiCreateIssueConfig） 2024/02/17 新增查询审批流（API名称：openSceneTask/findReviewProcessList） 2024/02/17 新增新增审批流（API名称：openSceneTask/addTaskReviewProcess） 2024/02/17 新增批量删除标准条目（API名称：openStandardItem/batchDeleteStandardItemInfo） 2024/02/17 新增批量保存标准条目信息（API名称：openStandardItem/saveStandardItemInfo） 2024/02/17 新增分页查询标准条目及输出项（API名称：openStandardItem/searchStandardItemInfoList） 2024/02/17 新增根据itemId查询条目（API名称：openStandardItem/queryStandardItemInfo） 2024/02/17 新增查询结构文档目录（API名称：openTaskScene/queryProcess） 2024/02/17 新增取消ai告警（API名称：openTask/cancelHelmetAi） 2024/02/17 新增取消告警（API名称：openTask/cancel） 2024/02/17 新增获取告警的设备列表（API名称：getAlarmTypeIsdpDeviceIds） 2024/02/17 新增查询当前告警信息（API名称：openTask/queryAlarms） 2024/02/17 新增统计年度/月度总得分（API名称：queryBonusStatistics） 2024/01/31 新增查询指定人员积分数据详情（API名称：queryBonusValDetails） 2024/01/31 新增按时间段查询人员总分（API名称：queryBonusSumVal） 2024/01/31 新增根据ID查询最新的场景模板（API名称：openTaskScene/queryNewSceneList） 2024/01/31 新增修改任务状态（API名称：openTaskScene/updateTaskStatus） 2024/01/31 新增查询场景下子任务前后置关系（API名称：openTaskScene/findPreModeList） 2024/01/31 新增保存场景下子任务前后置关系（API名称：openTaskScene /savePreModeList） 2024/01/31 新增保存任务下子任务前后置关系（API名称：openTaskScene/savePreTaskList） 2024/01/31 新增批量删除子任务（API名称：openApiDeleteSubTask） 2024/01/31 新增查询文档生成信息（API名称：getTaskTemplateList） 2024/01/31 新增批量查询组织信息（API名称：notice/addNotice） 2024/01/29 新增上传PDF并截图（API名称：uploadFile） 2024/01/29 新增人员批量新增（API名称：batchAdd） 2024/01/29 新增保存excel导入导出记录（API名称：createRecord） 2024/01/29 新增手动割接数据（API名称：manualCutOverData/checkAndCutOver） 2024/01/29 新增查询打卡围栏配置信息（API名称：openApiQueryLocationSignConfig） 2024/01/25 新增文档生成（API名称：openQcTaskReport/addTaskReports） 2024/01/25 新增驳回任务（API名称：openTaskScene/rejectedTask） 2024/01/25 新增质检任务（API名称：openTaskScene/qualityTask） 2024/01/25 新增查询任务状态对应数量（API名称：queryTaskComponentCount） 2024/01/25 新增关闭任务（API名称：openTaskScene/closeTask） 2024/01/25 新增批量修改一级工艺顺序（API名称：openTaskScene/updateSequence） 2024/01/25 新增批量修改子任务（API名称：openTaskScene/batchUpdateSubTask） 2024/01/25 新增批量增加子任务（API名称：openTaskScene/batchSaveSubTask） 2024/01/25 新增任务子任务完成（API名称：openTaskScene/completeTask） 2024/01/25 新增任务子任务开始（API名称：openTaskScene/startTask） 2024/01/25 新增批量用户授权(新增用户角色权限)（API名称：addUserRoles） 2024/01/23 新增excel解析转换成json格式数据（API名称：excelToJson） 2024/01/23 新增分页查询岗位信息（API名称：findPagedPosition） 2024/01/23 新增根据ID更新人员信息（API名称：person/update） 2024/01/23 新增批量注销人员（API名称：batchDeregisterPerson） 2024/01/23 新增查询人员信息（API名称：getPersonList） 2024/01/23 新增根据班组id查询扩展信息（API名称：findExtInfoByTeam） 2024/01/23 新增批量删除班组（API名称：batchDeleteTeamByPersonGroupId） 2024/01/23 新增分页查询班组（API名称：findPagedTeamByPersonGroupName） 2024/01/23 新增更新班组（API名称：personGroup/updateTeam） 2024/01/23 新增更新小组（API名称：personGroup/updateGroup） 2024/01/23 新增新增班组（API名称：personGroup/addTeam） 2024/01/23 新增新增小组（API名称：personGroup/addGroup） 2024/01/23 新增批量删除小组（API名称：batchDeleteGroupByPersonGroupId） 2024/01/23 新增分页查询小组（API接口：findPagedGroupByNameAndParentId） 2024/01/23 新增报表管理章节 2024/01/23 新增通过名称下载模板（API名称：getTemplateExcel） 2024/01/23 新增人员信息导出（API名称：exportPersonModel） 2024/01/23 新增人员相关导入（API名称：importData） 2024/01/23 新增导入导出任务查询（API名称：findPageExcelRecordModelListById） 2024/01/23 更新问题个数统计（API名称：getCountModel） 2024/01/22 新增通过人员编码查询人员信息（API名称：findPersonByPersonCode） 2024/01/22 新增获取license信息（API名称：getLicenseInfo） 2024/01/22 新增声网实时消息回调（API名称：agoraMsgCallback） 2024/01/22 新增华为云推流通知回调（API名称：pushCallBack） 2024/01/22 新增华为云录制信息回调（API名称：vodCallBack） 2024/01/22 新增好望云摄像机告警消息回调（API名称：ivmAlarm/alarmMsg） 2024/01/22 新增批量获取入会（API名称：SaasLive/getTokenBatch） 2024/01/22 新增获取入会（API名称：SaasLive/getToken） 2024/01/22 新增批量查询设备直播信息及状态（API名称：queryLiveInfoBatch） 2024/01/22 新增获取设备轨迹信息（API名称：getTrailList） 2024/01/22 新增好望云摄像头抓拍接口（API接口：cameraVideoCaptrue） 2024/01/22 新增查询角色列表分页（API名称：findPagedRoleList） 2024/01/17 新增技能列表查询（API名称：findSkillList） 2024/01/17 新增租户技能领域分页查询（API名称：getPagedSkillDomainList） 2024/01/17 新增租户技能等级分页查询（API名称：getPagedSkillLevel） 2024/01/17 新增更新作业资质（API名称：operationQual/update） 2024/01/17 新增批量删除作业资质（API名称：operationQual/batchDelete） 2024/01/17 新增分页查询作业资质（API名称：findPagedOperationQualList） 2024/01/17 新增新增作业资质（API名称：operationQual/add） 2024/01/17 更新检查单采集完成（API名称：batchSubmitCollectData） 2024/01/17 更新创建安全视频模版（API名称：batchAddTemplates） 2024/01/17 更新新增问题（API名称：createIssue） 2024/01/17 更新创建任务调度（API名称：createTaskSchedule） 2024/01/17 更新获取lookup条目清单（API名称：findLookupList）接口信息 2024/01/11 更新新增人员账号（API名称：person/add）接口信息 2024/01/11 更新查询租户下用户信息（API名称：getPersonListByTenant）接口信息 2024/01/11 删除删除场景模板，相关接口见删除任务场景（API名称：deleteTaskScene） 2024/01/04 删除查询检查单状态，相关接口见任务分页查询（API名称：findTask） 2024/01/04 删除任务人脸资质采集明细查询，详细接口见查询人员资质（API名称：findTaskIdentify） 2023/12/13 删除任务报告查询，相关接口见查询质检报告（API名称：findTaskReport） 2023/12/13 更新查询行政区域（API名称：findPagedAddress），删除按层级（下一层）查询位置信息。 2023/12/12 更新查询条目采集结果（API名称：findTaskCollectinfo），删除查询任务采集数据。 2023/12/12 更新批量新增作业对象（API名称：batchAddAndUpdateTaskObject） 2023/11/14 新增更新工具状态（API名称：updateToolStatus） 2023/11/02 新增查询场景模板列表（API名称：querySceneList）， 复制场景模板（API名称：copySceneBase）， 删除场景模板（API名称：deleteTaskScene） 2023/10/19 更新脱敏查询作业对象（API名称：querySignSites） 2023/10/19 新增查询单个人员信息（API名称：findPersonMoreInfoByPersonCode） 2023/10/18 新增查询积分项（API名称：queryBonusTerm）， 创建积分（API名称：saveBonusTermList）， 批量保存积分明细（API名称：saveOpenApiBonusDetail）， 删除积分明细（API名称：batchDeleteBonusList） 2023/09/12 将查询任务列表（API名称：queryParentTaskList）合入查询父任务（API名称：queryParentTaskList） 2023/08/23 更新生产资料管理章节下全部API的外部链接信息 2023/08/11 新增DPR算法向量化条目添加（API名称：aiDpr/add） 2023/07/17 新增DPR算法向量化条目删除（API名称：aiDpr/delete） 2023/07/17 新增DPR算法向量化条目修改（API名称：aiDpr/update） 2023/07/17 新增DPR算法向量化条目检索（API名称：aiDpr/match） 2023/07/17 修改新增工序任务（API名称：createProcedureTask）新增Toolset工具集参数 2023/07/10 修改新增父子任务（API名称：createSubTask）新增Toolset工具集参数 2023/07/10 修改新增任务（API名称：createTask）新增Toolset工具集参数 2023/07/10 修改更新任务场景（API名称：updateTaskScene）中sceneMode参数的说明 2023/07/06 新增批量更新人员信息（API名称：person/batchUpdate） 2023/06/02 修改处理人申请关闭问题（API名称：issueApplyClose）新增了上传附件的功能 2023/05/25 新增创建父子任务（API名称：createSpecificSubTask） 2023/05/25 修改修改任务（API名称：modifyTask） 2023/05/10 修改新增父子任务（API名称：createSubTask） 2023/05/10 新增批量修改任务（API名称：batchModifyTaskList） 2023/05/10 修改查询父任务&子任务（API名称：queryParentAndSubTaskInfos） 2023/05/09 新增批量修改计划时间（API名称：openApiBatchUpdatePlanTime） 2023/05/09 新增批量创建父子任务（API名称：batchCreateSubTaskList） 2023/05/09 新增安监设备关联模版（API名称：openApiHelmetTemplate/save） 2023/05/09 新增查询安全视频模版（API名称：queryTemplates） 2023/05/09 新增修改安全视频模版（API名称：batchUpdateTemplates） 2023/05/09 新增创建安全视频模版（API名称：batchAddTemplates） 2023/05/09 新增根据父级ID查询所有对象信息（API名称：findListByParentId） 2023/05/09 新增根据分类ID查询所有对象信息（API名称：findIntelligentObjectModel） 2023/05/09 新增查询租户所在的行业（API名称：findTenantIndustry） 2023/05/09 新增查询任务报告列表（API名称：queryTaskReportList） 2023/05/04 新增查询与会者信息（API名称：queryParticipantsById） 2023/04/19 新增新建课程信息（API名称：openApiCreateCourse） 2023/04/19 新增课程保存草稿/发布课程信息（API名称：openApimodifyCourse） 2023/04/19 新增单个保存大纲章节（API名称：openApiSaveOutlineChapter） 2023/04/19 新增查询附近作业对象（API名称：findNearSite）openApi 2023/04/04 新增权限角色相关openApi 2023/04/04 修改新增待办（API名称：addMyTodo）部分入参字段描叙 2023/03/17 新增保存任务/子任务执行阶段扩展属性（API名称：saveTaskExtendFieldList） 2023/02/21 新增查询父任务&子任务（API名称：queryParentAndSubTaskInfos） 2023/02/21 修改查询子任务（API名称：OpenSceneTask/querySubTaskList） 2023/02/21 修改新增工序任务场景（API名称：createTaskScene） 2023/02/21 修改创建任务场景（API名称：createTaskSceneTemplate） 2023/02/21 修改新增任务（API名称：createTask） 2023/02/21 修改新增父子任务（API名称：createSubTask） 2023/02/21 修改查询父任务（API名称：queryParentTaskList） 2023/02/21 修改修改任务（API名称：modifyTask） 2023/02/21 修改查询任务场景详情（API名称：getTaskSceneConfigInfo） 2023/02/21 修改更新任务场景（API名称：updateTaskScene） 2023/02/21 迁移创建租户全局扩展属性（API名称：batchSaveOrUpdateTaskExtend） 2023/01/12 迁移查询租户全局扩展属性（API名称：queryGlobalTaskExtend） 2023/01/12 新增检测智能对象（旧版本）（API名称：proxyTeslaService） 2023/01/11 新增根据条件查询采集信息中的图片（API名称：queryCollectPhotoDetail） 2023/01/10 新增查询作业对象筛选的执行人数量（API名称：queryJobTaskExecutor） 2023/01/10 新增根据条件查询所有场景ID（API名称：queryTaskPictureByCondition） 2023/01/10 新增查询场景或领域的任务数量（API名称：queryCategoryCount） 2023/01/10 新增查询作业对象筛选的任务平均时长（API名称：queryJobTaskAverageTime） 2023/01/10 新增各类别隐患整改统计（API名称：queryRectificationByType） 2023/01/10 新增查询检查单条目下面的采集图片明细数据（API名称：queryCheckOrderCollectPhotoDetail） 2023/01/10 新增查询包含图片的任务场景（API名称：getTaskPicture） 2023/01/10 新增根据作业对象、任务类型及任务状态获取任务个数（API名称：getTaskNumByJobObject） 2023/01/10 新增获取kcp一次性通过率（API名称：getKcpOneTimePassRate） 2023/01/10 新增查询指定设备的故障等级分布（API名称：deviceIssueLevel） 2023/01/10 新增查询指定设备的故障类型分布（API名称：deviceIssueType） 2023/01/10 新增查询指定设备的故障次数趋势（API名称：deviceIssueTimesTrend） 2023/01/10 新增查询指定设备的巡检自检结果分布（API名称：deviceTaskReviewResult） 2023/01/10 新增各问题类别新增问题数统计（API名称：queryNewIssueByIssueType） 2023/01/10 新增各组织任务数排行（API名称：orgTaskNumberRank） 2023/01/10 新增各组织问题按时关闭率统计（API名称：inTimeCompleteIssue） 2023/01/10 新增各组织新建问题数排行（API名称：orgCreateIssueNumberRank） 2023/01/10 新增关闭问题趋势统计（API名称：closeIssueTrend） 2023/01/10 新增任务按时完成率（API名称：inTimeCompleteTask） 2023/01/10 新增任务平均执行时长（API名称：taskAverageExecuteTime） 2023/01/10 新增任务跳转ID查询（API名称：queryJumpIssueCode） 2023/01/10 新增任务状态趋势统计（API名称：taskStatusTrend） 2023/01/10 新增问题跳转编码查询（API名称：queryJumpTaskId） 2023/01/10 新增新建问题趋势统计（API名称：queryNewIssueTrend） 2023/01/10 修改查询租户下用户信息（API名称：getPersonListByTenant） 2022/12/6 新增查询设备告警信息（API名称：queryOpenHelmetAlarms） 2022/12/5 新增创建多方协同会议（API名称：createConference） 2022/12/5 新增邀请用户或设备（API名称：inviteParticipants） 2022/12/5 新增结束会议（API名称：closeConference） 2022/12/5 新增挂断或移除用户（API名称：delParticipant） 2022/12/5 新增录制多方协同会议（API名称：captureConferenceVideo） 2022/12/5 新增停止录制会议（API名称：stopConferenceCapture） 2022/12/5 新增维护转派任务/子任务执行人（API名称：batchTransferExecutor） 2022/11/18 新增课程详情查询服务（API名称：openApiGetUserCourseByCourseId） 2022/11/17 新增课程学习列表查询服务（API名称：openApiGetPageMyUserCourse） 2022/11/17 新增班前会打卡（API名称：openApiSign） 2022/11/15 新增根据消息Id删除消息（API名称：deleteMessageModelByIds） 2022/11/9 新增根据用户Id查询消息（API名称：findPagedMessageListByUser） 2022/11/9 新增创建大数据导出任务（API名称：createJob） 2022/11/9 新增获取大数据导出任务状态（API名称：getJobStatus/taskId） 2022/11/9 新增获取大数据导出文件流（API名称：getFileByJob/taskId） 2022/11/9 新增查询设备台帐信息（API名称：getDeviceList） 2022/10/27 新增删除任务（API名称：deleteSceneTask） 2022/10/27 新增修改任务（API名称：modifyTask） 2022/10/27 新增批量提交任务（API名称：modifyTaskLists） 2022/10/27 新增查询检查单详情（API名称：findModelByTaskId） 2022/10/27 新增创建检查单模板头信息（API名称：createQcTemplate） 2022/10/27 新增新增设备台账基础信息（API名称：addOpenDeviceInfo） 2022/9/23 新增更新设备台账信息（API名称：updateOpenDeviceInfo） 2022/9/23 新增删除设备台账信息（API名称：deleteOpenDeviceInfoo） 2022/9/23 新增获取各个租户下的用户数（API名称：getUserCountOfEachTenant） 2022/9/19 新增查询设备关联的任务数量（API名称：getTaskStatistic） 2022/9/16 新增查询设备关联的任务逾期数量（API名称：getExpireTaskCount） 2022/9/16 新增查询设备关联的任务&子任务列表（API名称：getSceneTaskList） 2022/9/16 新增修改检查单模板智能分析输出项（API名称：batchUpdateOutPutUrl） 2022/9/9 新增获取租户下的logo信息（API名称：findLogoBannerInfo） 2022/9/8 新增根据位置名称批量查询位置信息(含中文路径)（API名称：batchFindAddress） 2022/8/25 新增根据位置名称查询位置信息（含层级）（API名称：findPagedAddressByName） 2022/8/25 新增查询组织树结构信息（API名称：findTreeOrgInfo） 2022/8/25 新增批量查询客户和客户分组信息（API名称：batchFindCustomerList） 2022/8/17 新增批量查询供应商信息和供应商分组信息（API名称：batchFindSupplierList） 2022/8/16 新增查询供应商和供应商分组信息（API名称：getPagedSupplierList） 2022/8/15 新增查询客户和客户分组信息（API名称：getPagedCustomerList） 2022/8/15 新增保存作业对象分组信息(新增/修改)（API名称：saveTaskObjGroup） 2022/8/11 新增删除作业对象分组信息（API名称：batchDelTaskObjGroup） 2022/8/11 新增批量保存客户（API名称：batchSave） 2022/8/9 新增批量删除客户（API名称：batchDelete） 2022/8/9 新增批量保存岗位（API名称：batchSave） 2022/8/9 新增批量删除岗位（API名称：batchDelete） 2022/8/9 新增批量保存地理信息（API名称：batchSave） 2022/8/9 新增批量删除地理信息（API名称：batchDelete） 2022/8/9 新增获取lookup条目清单（API名称：findLookupList） 2022/8/9 刷新查询问题对应的操作记录（API名称：getTaskIssueLogModel） 2022/8/8 刷新验收人批量操作问题（API名称：acceptanceUserBatchOperate） 2022/8/8 新增批量提交问题（API名称：batchSubmitIssue） 2022/8/8 新增查询每日创建问题数（API名称：queryIssueEveryDayCount） 2022/8/8 新增检查单采集完成（API名称：batchSubmitCollectData） 2022/8/4 新增检查单NA采集（API名称：saveOrUpdateItemToNA） 2022/8/4 新增检查单采集数据（API名称：batchUpdateCollectData） 2022/8/4 新增创建任务调度（API名称：createTaskSchedule） 2022/8/4 新增修改任务调度（API名称：updateTaskSchedule） 2022/8/4 新增查询任务调度列表（API名称：findTaskScheduleList） 2022/8/4 新增删除任务调度（API名称：deleteTaskSchedule） 2022/8/4 新增查询任务调度明细（API名称：findTaskScheduleById） 2022/8/4 新增查询任务日志（API名称：findSceneTaskLogs） 2022/8/4 新增按状态统计任务数量（API名称：querySceneTaskStatusCount） 2022/8/4 新增查询任务下检查单采集日志（API名称：queryTaskLog） 2022/8/4 新增检测智能对象（标准）（API名称：detect） 2022/8/3 新增检测指定时长或范围的智能对象（API名称：detect） 2022/8/3 新增检测多人作业（API名称：detect） 2022/8/3 刷新新增任务（API名称：createTask） 2022/8/3 新增查询任务列表（API名称：queryParentTaskList） 2022/8/3 新增查询任务问题数量（API名称：queryTaskIssueCount） 2022/8/3 新增查询任务明细（API名称：getTaskInfo） 2022/8/3

请求示例 { "issueInstance":"1", "isFilterReceiveStatus":1, "code":"11111", "riskList":[{"riskId":11111,"issueItemId":"11144444","issueRiskMeasuresId":12121,"issueRiskMeasures":"dfdfdfdd"}], "issueTypeFather":"dfdfdfd", "issueType":"dfdfdfdererere", "signSiteId":"98908817", "issueHandlerId":"467848", "issueHandlerName":"呵呵", "department":"833", "issueLevel": 0, "issueAttachmentList": [ { "fileId": 6525907, "fileName": "变更日志.xlsx", "fileType": "xlsx" } ], "udf17": "", "udf14": "", "udf13": "12345689012345678901234567890123456789012345617890", "udf5": "", "udf6": "1650816000000", "udf10": "测试", "udf3": "12345678011234567890123456789012345678901234567123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890890", "udf20": "", "udf4": "1650852785000", "udf1": "", "udf2": "", "checkUserList":[{"userId":467848,"userName":"呵呵","userType":"1","orgId":833,"orgName":"23232","orgPath":"中国区11112223333"}], "acceptanceUserList":[{"userId":467848,"userName":"呵呵","userType":"1","orgId":833,"orgName":"23232","orgPath":"中国区11112223333"}], "supervisedUserList":[{"userId":467848,"userName":"呵呵","userType":"1","orgId":833,"orgName":"23232","orgPath":"中国区11112223333"}], "creatorDescribe": "嘿嘿dddd${number}", "dueTimestamp": "", "issueRemark": "ddddddddd", "action": 1, "issueSource": 5, "submitterAccount":"18829266100", "issueHandlerAccount":"1512948340911" }

响应参数 参数 类型 描述 stateCode String 响应状态码：0-成功；其他-失败 errorMessage String 响应描述 result Object 响应结果内容 result参数： 参数 类型 描述 slaStatus Integer SLA状态，1：正常，2：临期，3：逾期，0：-- submitPending String 提交待处理的时间 status Integer 问题状态(1-草稿，2-处理中 ,3-已处理待关闭，4-已关闭，5-待处理) udf1-udf20 String 扩展属性 signSiteId String 作业对象id signSiteName String 作业对象名称 signSiteCode String 作业对象编码 issueTypeCode String kindScene问题类别适用的场景 UDF8-默认 UDF1-安全视频;UDF4-巡检;UDF5-质检;UDF6-视频通话;UDF7-智能安监;UDF9-任务相关 issueLevel Integer 问题严重级别(0-一般,1-重要,2-严重) issueSource String 问题来源("0"-"审核问题"; "1"-"执行问题") issueHandlerId String 处理人id issueHandlerName String 处理人名称 createSupplierName String 供应商名称 adminOrganization String 组织单元ID adminOrganizationName String 组织单元名称 issueHandlerSupplierName String 问题处理提供者名称 issueInstance String 问题实例标识 code String 问题编码 tenantId Long 租户ID createName String 创建人名称 creationTimestamp Long 创建时间戳 createdBy Long 创建人ID creationDate Date 创建时间 lastUpdateName String 最后更新人名称 lastUpdateBy Long 最后更新人ID lastUpdateDate Date 最后更新时间 deleteFlag Integer 删除标识0，正常，1删除 dueTimestamp Long 要求完成时间戳 issueType String 问题小类 issueTypeFather String 问题大类 issueCarbonCopyList List 问题抄送人集合 action Integer 0：保存草稿 1：提交 issueAttachmentList List 附件集合 riskList List 问题风险 checkUserList List 检查人清单，多个人用逗号隔开 acceptanceUserList List 验收人，多个人用逗号隔开 supervisedUserList List 监督人，多个人用逗号隔开 issueRemark String 问题备注 creatorDescribe String 创建人描述 department String 责任部门ID departmentName String 责任部门名称 departmentPath String 责任部门路径 orgPath String 组织单元节点ID region String 行政区域 regionId Long 行政区域ID regionName String 行政区域名称 regionPath String 行政区域路径 issueAttributeModel List 问题扩展属性 entityName String 实体名称 issueId Long 问题ID lastUpdatedBy Long 最后更新人Id appName String 服务名称

相关API 接口名称 调用说明 获取Token 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加“Authorization”，其值即为Token。 查询(上/下级)组织信息（API名称：findPagedOrgListWithDirection） 分页查询组织信息内容，含上/下级组织单元 查询条目问题单 创建问题单后，如果创建的为条目问题单，可以调用该接口查询创建的条目问题单。（条目问题单：质量检查任务在执行过程中，或者质量审核过程中创建的“问题”） 新增问题类型 新建问题时需要先选择问题类型，通过此接口创建 明文查询作业对象（API名称：plaintextQuerySignSite） 对作业对象进行查询时使用

请求参数 参数 类型 是否必填 描述 issueInstance String 是 问题实例,1 隐患，0 问题 code String 否 问题编码，可以传值，如果不传值则创建后，根据后台默认规则生成 riskList List 否 问题风险 issueTypeFather String 否 问题大类 issueType String 否 问题小类 说明： 问题大类和小类同时入参时，小类入参的形式是：大类#小类 issueLevel String 否 问题级别，传枚举代码：0，1，2 issueSource String 是 问题来源 issueRemark String 否 问题备注 issueAttachmentList List 否 附件 action Integer 是 0：保存草稿 1：提交 creatorDescribe String 是 问题描述 adminOrganization String 否 创建人对应组织ID（由创建人关联带入，可不传） adminOrganizationName String 否 创建人对应组织名称（由创建人关联带入，可不传） signSiteId Long 否 作业对象ID signSitecode String 否 作业对象编码 signSiteName String 否 作业对象名称 issueHandlerId String 否 执行人 issueHandlerName String 否 执行人名称 department String 否 责任部门编码/ID departmentName String 否 责任部门名称 checkUserList List 否 检查人清单，多个人用逗号隔开 acceptanceUserList List 否 验收人，多个人用逗号隔开 supervisedUserList List 否 监督人，多个人用逗号隔开 url String 否 待办跳转的第三方web地址 thirdUrl String 否 待办跳转的第三方app端页面地址 dueTimestamp Long 否 计划完成时间戳 dealDate Long 否 自动上传的处理时间 submitterAccount String 是 提交人账号 isFilterReceiveStatus Integer 是 1是代表问题提交执行中，0是代表问题提交到待执行，处理人需要接受。 issueHandlerAccount String 否 问题处理人账号 udf1—udf20 - - 问题扩展属性

响应示例 { "stateCode": "0", "errorMessage": null, "result": [ { "appName": "isdp-task-server", "checkBusiType": "许可01", "checkOrderId": 6119716, "checkOrderType": 1, "createdBy": 930218, "createName": "汤文祥", "creationDate": "2024-01-27T01:43:00.000+00:00", "creationTimestamp": 1706319780789, "deleteFlag": 0, "entityName": "WorkTicketPhase", "isRejected": 0, "lastUpdateDate": "2024-01-27T01:43:01.000+00:00", "lastUpdatedBy": 930218, "lastUpdateName": "汤文祥", "lastUpdateTimestamp": 1706319780789, "reviewSwitch": 0, "sceneInitialStatus": 1083, "sceneSumbmitStatus": 1521, "submitUserName": null, "templateCode": "QC202XXXXXXXXXXXXXX", "templateId": 313068, "tenantId": 886, "ticketId": 143294, "ticketPhaseCode": "51815", "ticketPhaseId": 402060, "ticketPhaseName": "阶段1", "ticketPhaseOrder": 1, "ticketPhaseStatus": 1, "kcpList": [ { "kcpId": 438668, "name": "new kcp1", "templateId": 313068, "children": [ { "collectNa": 0, "allowedNa": 1, "appName": "isdp-qc-server", "createdBy": 153169, "creationDate": "2023-06-30T07:03:50.000+00:00", "deleteFlag": 0, "entityName": "TemplateItem", "handlerNameInspection": null, "handlerNameQualityInspection": null, "identificationType": "", "intelligentReviewRules": "", "isExemption": 0, "issueHandlerInspection": null, "issueHandlerQualityInspection": null, "issueTypeInspection": "", "issueTypeQualityInspection": "", "itemCode": null, "itemId": 3576667, "itemIndex": 0, "itemType": 0, "kcpId": 438668, "kcpIndex": 0, "kcpName": null, "lastUpdateDate": "2023-06-30T07:03:50.000+00:00", "lastUpdatedBy": 153169, "name": "Item1", "objectIndustryTypeId": null, "objectIndustryTypeIdText": null, "operationGuide": "", "qualificationType": 1, "qualityStandard": "", "rejectionReason": null, "sceneTypeName": null, "severity": 1, "templateId": 313068, "tenantId": 886, "approveStatus": 1, "reviewStatus": 4, "collectStatus": 2, "aiResult": "wait", "colletData": { "itemId": 3576667, "itemName": "Item1", "itemType": 0, "itemRemark": null, "itemContent": null, "itemCheckResult": null, "isOldDate": null, "kcpId": null, "ratingType": null, "itemScore": null, "children": [ { "itemId": 3576667, "outputId": 43955188, "outputName": "1", "outputCode": null, "countPhoto": 0, "countVideo": 0, "outputType": 13, "collectScene": null, "qualificationType": null, "isNecessary": null, "compressionRatio": null, "demoPictureId": null, "maxPhoto": 0, "maxVideo": 0, "enablePhoto": null, "outputModel": { "itemId": 3576667, "templateId": 313068, "outputId": 43955188, "outputName": "1", "outputType": 13, "maxPhoto": null, "maxVideo": null, "isNecessary": 0, "qualificationType": null, "enumValue": "", "maxValue": "", "minValue": "", "enablePhoto": null, "compressionRatio": null, "demoPictureId": null, "deleteFlag": 0, "accuracy": null, "cascadeOutputId": null, "collectScene": 0, "designValue": "", "deviationValue": null, "designValueOrder": null, "isSubOutput": null, "oldItemId": null, "itemType": 0, "isAudioIdentify": 0, "measurementOrder": 0, "defaultValue": "", "outputCode": null, "isStrongWeak": null, "intelligentObject": "", "isCascading": 0, "parentEnum": null, "parentEnumName": null, "parentOutputId": null }, "itemName": null, "isCascading": 0, "parentEnumName": null, "cascadeOutputId": null, "parentEnum": null, "parentOutputId": null, "kcpName": null, "qcExamplePhotoModelList": [], "qcExampleVideoModelList": [], "qcPhotoModelList": [], "qcVideoModelList": [], "qcFileModelList": [], "qcCollectionDataModelList": [] } ] } } ] } ] } ] }

响应参数 参数 类型 描述 stateCode String 响应状态码： 0-成功 其他-失败 errorMessage String 响应描述 result Object 响应结果内容data、分页数据 result 参数 类型 描述 appName String 应用名称 checkBusiType String 检查单业务类型 checkOrderId Long 工作票阶段检查单ID checkOrderType Integer 工作票阶段生成的检查单类型(0：EHS;1:质量检查;2:巡检) createdBy Long 创建人 createName String 创建名称 creationDate Date 创建时间 creationTimestamp Long 创建时间戳 deleteFlag Integer 删除标识 entityName String 实体名称 isRejected Integer 是否已驳回（0-否；1-是） lastUpdateDate Date 最近更新日期 lastUpdatedBy Long 最近更新人 lastUpdateName String 最近更新人名称 lastUpdateTimestamp Long 最近更新人时间戳 reviewSwitch Integer 是否启用审批开关(1-是 2-否) sceneInitialStatus Long 初始状态ID sceneSumbmitStatus Long 提交状态ID submitUserName String 提交人 templateCode String 工作票模板编码 templateId Long 工作票模板ID tenantId Long 租户ID ticketId Long 工作票ID(许可单ID) ticketPhaseCode String 工作票阶段编码 ticketPhaseId Long 工作票阶段ID ticketPhaseName String 工作票阶段名称 ticketPhaseOrder Integer 工作票阶段序号 ticketPhaseStatus Integer 工作票阶段状态（1-初始状态,待执行 2-阶段执行中(审批翻转)3-阶段完成） kcpList List Kcp列表 kcpList： 参数 类型 描述 kcpId Long Kcp id name String Kcp名称 templateId Long 模板id children Int Item列表 children: 参数 类型 描述 id Long 拓展属性id itemId Long Item id itemIndex Int Item下标排序 itemType Int 条目类型（1：临时检查项；0：非临时检查项；2：标准条目） name String 条目名称 approveStatus Int 1、未提交审核 2、待评审 3、已评审 collectStatus Int 采集状态: 1：待采集 2：已采集 colletData List 采集数据列表 colletData: 参数 类型 描述 itemId Long Item id itemType Int 条目类型（1：临时检查项；0：非临时检查项；2：标准条目） children List 输出项列表 children出参: 参数 类型 描述 itemId Long Item id outputId Long 输出项id outputName String 输出项名称 countPhoto Int 已采集图片数量 countVideo Int 已采集视频数量 outputType Int 输出项类型 16：文件 15：时间(年月日时分) 13：图片 14：视频 3:图片/视频 2:文本 5:整数 6:小数 1:枚举 4:多枚举 11:GPS 9:条码 7:日期 10:NA 17音频 18签名 maxPhoto Int 最大图片数量 maxVideo Int 最大视频数量 outputModel List 输出项子项 qcVideoModelList List 采集的视频列表 qcPhotoModelList List 采集的图片列表 qcFileModelList List 采集的文件列表 qcCollectionDataModelList List 采集数据列表

请求消息体 请求消息体通常以结构化格式发出，与请求消息头中Content-type对应，传递除请求消息头之外的内容。若请求消息体中参数支持中文，则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于获取ISDP+ Token接口，您可以从接口的请求部分看到所需的请求参数及参数说明。 将消息体加入后的请求如下所示，加粗的斜体字段需要根据实际值填写，其中***********为应用ID，xxxxxxxxxx为应用令牌，获取方法请参见创建应用。 POST https://isdpcloud-beta.sd.huawei.com/oauth2/oauth/rest_token Content-Type: application/json { "client_id": "isdp-saas-openapi", "client_secret": "isdp-saas-openapi", "grant_type": "password", "username": "**********", "password": "xxxxxxxxxx" }

发起请求 到这里为止这个请求需要的内容就具备齐全了，您可以使用Postman或直接编写代码等方式发送请求调用API。 对于获取ISDP+ Token接口，返回的响应消息体中“access_token”和“token_type”就是组成ISDP+ Token的值。有了Token之后，您就可以使用Token认证调用其他ISDP+ OpenAPI。 ISDP+ Token=“token_type access_token”（注意两个字段之间有空格）。

请求URL 请求URL由如下部分组成。 {URL-scheme}://{Endpoint}/{resource-path}?{query-string} 表1 请求URL 参数 说明 URI-scheme 表示用于传输请求的协议，当前所有API均采用HTTPS协议。 Endpoint 指定承载REST服务端点的服务器域名或IP。 例如ISDP+测试环境服务器的Endpoint为“isdpcloud-beta.sd.huawei.com”。 resource-path 资源路径，即API访问路径。从具体API的URL模块获取，例如“获取ISDP+Token”API的resource-path为“/oauth2/oauth/rest_token”。 query-string 查询参数，是可选部分，并不是每个API都有查询参数。查询参数前面需要带一个“？”，形式为“参数名=参数取值”，例如“limit=10”，表示查询不超过10条数据。 例如您需要获取ISDP+的Token，“/oauth2/oauth/rest_token”为资源路径，假设ISDP+测试环境域名为“isdpcloud-beta.sd.huawei.com”，URL拼接起来如下所示。 https://isdpcloud-beta.sd.huawei.com/oauth2/oauth/rest_token

请求方法 HTTP请求方法（也称为操作或动词），它告诉服务你正在请求什么类型的操作。 表2 HTTP请求方法 方法 说明 GET 请求服务器返回指定资源。 PUT 请求服务器更新指定资源。 POST 请求服务器新增资源或执行特殊操作。 DELETE 请求服务器删除指定资源。 HEAD 请求服务器资源头部。 PATCH 请求服务器更新资源的部分内容。当资源不存在的时候，PATCH可能会去创建一个新的资源。 在获取ISDP+ Token的URL部分，您可以看到其请求方法为“POST”，则其请求为： POST https://isdpcloud-beta.sd.huawei.com/oauth2/oauth/rest_token

请求消息头 附加请求头字段，如指定的URL和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。 详细的公共请求消息头字段请参见表3。 表3 公共请求消息头 消息头名称 描述 是否必选 Content-Type 消息体的类型（格式），HTTP协议中设定的一个参数，用于标识返回的内容用什么格式去解析。 消息体的类型请参见API接口中API的说明。 是 Authorization ISDP+的Token，调用ISDP+的API要用到的访问令牌，在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。 当前示例中API功能为获取Token，因此调用该接口时，不用填写本字段。 否 对于获取ISDP+ Token接口，由于不需要认证，所以只添加“Content-Type”即可，添加消息头后的请求如下所示。 POST https://isdpcloud-beta.sd.huawei.com/oauth2/oauth/rest_token Content-Type: application/json

响应示例 { "sceneId": 161143, "reviewProcessId": null, "sceneStatus": 1, "sceneRemark": "", "reviewProcessName": null, "sceneName": "许可场景", "sceneCode": "PS20240125171429695", "sceneMode": null, "sceneType": 2, "sceneLicense": null, "sourceSceneId": 161143, "version": "1.0", "isNewVersion": 0, "createdBy": 930218, "createName": "汤文祥", "lastUpdatedBy": 930218, "lastUpdateName": "汤文祥", "creationTimestamp": 1706174069695, "lastUpdateTimestamp": 1706174239128, "deleteFlag": 0, "signInConfig": null, "coverId": null, "category": null, "id": null, "parentCategory": null, "parentId": null, "adminOrganizationCode": "830", "adminOrganizationName": "杨凌作业系统测试", "dataSource": null, "keyPointConfig": null, "isApplyApprove": null, "fromSceneId": null, "sceneReviewId": null, "sceneReviewName": null, "taskSceneBaseFieldList": [ { "fieldCode": "11", "fieldDefaultValue": null, "fieldIsNecessary": 2, "fieldName": "1111", "fieldOrder": 0, "fieldStatus": 1, "sceneBaseFieldId": 1900015, "sceneId": 161143, "defaultFilter": null }, { "fieldCode": "taskDescription", "fieldDefaultValue": null, "fieldIsNecessary": 1, "fieldName": "任务描述", "fieldOrder": 2, "fieldStatus": 1, "sceneBaseFieldId": 1900016, "sceneId": 161143, "defaultFilter": null } ], "taskSceneExtendFieldList": [ { "sceneExtendFieldId": 258399, "sceneId": 161143, "fieldName": "1323", "fieldCode": "UDF1", "parentExtendFieldId": 0, "fieldType": 1, "fieldStatus": 1, "fieldIsNecessary": 1, "fieldOrder": 1, "fieldValue": null, "fieldDefaultValue": "", "isNewWay": 1, "stage": 1, "unitName": null, "minValue": null, "maxValue": null, "precision": null }, { "sceneExtendFieldId": 258400, "sceneId": 161143, "fieldName": "13", "fieldCode": "UDF2", "parentExtendFieldId": 0, "fieldType": 1, "fieldStatus": 1, "fieldIsNecessary": 1, "fieldOrder": 2, "fieldValue": null, "fieldDefaultValue": "", "isNewWay": 1, "stage": 1, "unitName": null, "minValue": null, "maxValue": null, "precision": null } ], "scenePhaseList": [ { "scenePhaseId": 51874, "sceneId": 161143, "scenePhaseName": "13", "initialStatus": 1171, "initialStatusMame": "执行中", "initialSystemStatusCode": "2", "initialSystemStatusName": "已许可", "initialSystemStatusOrder": 2, "submitStatus": 1088, "submitStatusMame": "已终结", "submitSystemStatusCode": "3", "submitSystemStatusName": "已终结", "submitSystemStatusOrder": 3, "reviewStatus": null, "reviewStatusMame": null, "reviewSystemStatusCode": null, "reviewSystemStatusName": null, "reviewSystemStatusOrder": null, "templateId": "260849", "templateCode": "QC202XXXXXXXXXXXXXX", "isReview": 0, "reviewProcessId": null, "phaseOrder": 1, "creationDate": "2024-01-25T09:17:19.000+00:00", "creationTimestamp": 1706174239496, "lastUpdatedBy": 930218, "lastUpdateName": "汤文祥", "lastUpdateDate": "2024-01-25T09:17:19.000+00:00", "lastUpdateTimestamp": 1706174239496, "deleteFlag": 0, "templateExistFlag": "Y", "templateName": "视频相册选择长短文本", "templateVersion": "1.1", "templateType": "1" } ] }

响应参数 参数 类型 描述 stateCode String 响应状态码： 0-成功 其他-失败 errorMessage String 响应描述 result Object 响应结果内容data、分页数据 result出参： 参数 类型 描述 sceneId Long 场景ID reviewProcessId Long 任务场景配置审批流主键ID sceneStatus Integer 任务场景状态(0-草稿, 1-可用, 2-停用) sceneRemark String 任务场景描述 reviewProcessName String 任务场景配置审批流名字 sceneName String 任务场景名称 sceneCode String 任务场景编码 sceneMode Integer 任务场景模式(1-简单任务,2-关联作业检查清单,3-任务启用工序,4-父子任务) sceneType Integer 场景创建类型(0-按场景创建 1-手动创建虚拟场景 2-许可场景) sceneLicense Integer 配置许可(0-否,1-是) sourceSceneId Long 任务场景源头SCENE_ID(同一个父SCENE_ID) version String 版本号 isNewVersion Integer 是否是最新版本(0-最新版本；1-历史版本) createdBy Long 创建人 createName String 创建人名称 lastUpdatedBy Long 最近更新人 lastUpdateName String 最近更新人名称 creationTimestamp Date 创建日期 lastUpdateTimestamp Long 最近更新时间戳 deleteFlag Integer 删除标识0-正常 ，1-删除 signInConfig Integer 是否启用打卡配置（1-启用；0-不启用；null-该场景没有引入打卡配置） coverId Long 任务场景封面ID category String 任务类别 Id Long 任务类别ID parentCategory String 一级任务类别名称 parentId Long 一级任务类别ID adminOrganizationCode String 组织编码 adminOrganizationName String 组织名称 dataSource String 标识数据来源(0-默认 appcube-双预控) keyPointConfig Integer 关键控制点开关(1-启用，0-不启用) isApplyApprove Integer 是否需要申请审批(否:0,是:1) fromSceneId Long 来自升级任务场景主键SCENE_ID sceneReviewId Long 场景评审ID sceneReviewName String 场景评审名称 taskSceneBaseFieldList List 基础字段 taskSceneExtendFieldList List 扩展字段 scenePhaseList List 许可阶段列表 taskSceneBaseFieldList： 参数 类型 描述 fieldCode String 字段编码 fieldDefaultValue String 基础字段默认值 fieldIsNecessary Integer 是否必填(1-必填, 2-其它) fieldName String 字段名称/固定编码 fieldOrder Integer 字段排序序号 fieldStatus Integer 字段状态(1-可用, 2-停用) sceneBaseFieldId Long 任务场景基础字段主键ID sceneId Long 任务场景管理主键 defaultFilter String 基础字段默认条件（6：作业对象分组） taskSceneExtendFieldList： 参数 类型 描述 sceneExtendFieldId Long 任务场景扩展字段主键ID sceneId Long 任务场景管理主键 fieldName String 自定义字段名称 fieldCode String 字段编码(UDF+序号) parentExtendFieldId Long 扩展字段父ID(默认0父属性) fieldType Integer 字段类型(1-文本;2-枚举;3-多枚举;4-日期;5-时间) fieldStatus Integer 字段状态(1-可用, 2-停用) fieldIsNecessary Integer 是否必填(1-必填, 2-其它) fieldOrder Integer 字段排序序号 fieldValue String 字段枚举值(单枚举值) fieldDefaultValue String 字段默认值 isNewWay Integer 是否通过引入全局扩展属性创建的场景扩展属性(1-是；0-否) stage Integer 扩展属性所属阶段（1：创建；2：执行） unitName String 扩展属性单位名称 minValue String 扩展属性最小值(针对整数、小数类型有效) maxValue String 扩展属性最大值(针对整数、小数类型有效) precision Integer 精度 scenePhaseList: 参数 类型 描述 scenePhaseId String 工作票阶段主键ID sceneId Long 许可场景管理主键 scenePhaseName String 许可场景阶段NAME initialStatus Long 初始状态:LICENSE_STATUS_ID initialStatusMame String 初始阶段映射状态名称 initialSystemStatusCode String 初始阶段状态编码 initialSystemStatusName String 初始阶段状态名称 initialSystemStatusOrder Integer 初始阶段状态排序 submitStatus Long 提交后状态:LICENSE_STATUS_ID submitStatusMame String 提交阶段映射状态名称 submitSystemStatusCode String 提交阶段状态编码 submitSystemStatusName String 提交阶段状态名称 submitSystemStatusOrder Integer 提交阶段状态排序 reviewStatus Long 评审后状态:LICENSE_STATUS_ID reviewStatusMame String 评审阶段映射状态名称 reviewSystemStatusCode String 评审阶段状态编码 reviewSystemStatusName String 评审阶段状态名称 reviewSystemStatusOrder Integer 评审阶段状态排序 templateId Long 模板ID templateCode String 模板编码 isReview String 是否启用审批(0-否,1-是) reviewProcessId Long 任务场景配置审批流主键ID phaseOrder Integer 阶段排序序号 creationDate Date 创建日期 creationTimestamp Long 创建时间戳 lastUpdatedBy Long 最近更新人 lastUpdateName String 最近更新时间 lastUpdateDate Date 最近更新日期 lastUpdateTimestamp Long 最近更新时间戳 deleteFlag Integer 删除标识 templateExistFlag String 模板存在标识 templateName String 模板名称 templateVersion String 模板版本号 templateType Integer 业务类型

请求参数 参数 类型 是否必填 描述 client_id String 是 客户端ID，固定值isdp-saas-openapi client_secret String 是 客户端密钥，固定值isdp-saas-openapi grant_type String 是 授权模式，固定值password username String 是 订阅API的应用ID和令牌 获取方法请参见创建应用 password String 是

响应示例 { "access_token": "*****************", "token_type": "bearer", "expires_in": 359, "scope": "all", "plat_user": { "userId": 107027, "userNo": "XXXXXXXXXXX", "userName": "test", "userType": "API", "phone": null, "tenantId": 50222, "status": "0", "deleteFlag": 0, "pwdUpdateDate": "2022-03-17T02:35:04.000+00:00", "userExtendMap": { "clientId": "isdp-saas-openapi" }, "password": null, "salt": null, "currentLoginType": "password" } }

请求示例 { "beginDate": "2024-01-24", "endDate": "2025-01-24", "roleNo": "Admin", "positionList": [ { "positionCode": "ut岗位编码aa" } ], "rules": [ { "ruleCode": "1001" } ] }

认证鉴权 ISDP+提供的OpenAPI接口都需要通过认证之后才可以访问。认证方式为：在请求消息头上设置“Authorization”。 Token在计算机系统中代表令牌（临时）的意思，拥有Token代表拥有某种权限。Token认证是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。 Token可通过调用ISDP+ Token接口获取，请求body，如下所示，其中***********为应用ID，xxxxxxxxxx为应用令牌。 POST https://isdpcloud-beta.sd.huawei.com/oauth2/oauth/rest_token Content-Type: application/json { "client_id": "isdp-saas-openapi", "client_secret": "isdp-saas-openapi", "grant_type": "password", "username": "**********", "password": "xxxxxxxxxx" } 对于获取ISDP+ Token接口，返回的响应消息体中“access_token”和“token_type”就是组成ISDP+ Token的值。 ISDP+ Token=“token_type access_token”（注意两个字段之间有空格）。 获取Token后，再调用其他接口时，您需要在请求消息头中添加“Authorization”，其值即为Token，如下所示。 POST https://isdpcloud-beta.sd.huawei.com/openapi/v1/openSceneTask/createTask Authorization: bearer XXXXXXXXXXXXXX Content-Type: application/json 父主题： 接口调用方法

响应参数 参数 类型 描述 stateCode String 响应状态码： 0-成功 其他-失败 errorMessage String 响应描述 result Object 响应结果内容data、分页数据 result出参： 参数 类型 描述 category String 类别 subCategoryList List 子类别 industry Long 行业 isEnable Integer 是否启用（0-不启用；1-启用）

响应示例 { "stateCode": "0", "errorMessage": null, "result": [ { "lastUpdatedBy": 153169, "appName": "isdp-task-server", "lastUpdateDate": "2022-05-13T08:07:16.000+00:00", "orderNum": "11", "industry": "", "creationDate": "2022-05-13T08:07:16.000+00:00", "parentId": 0, "isEnable": 1, "deleteFlag": 0, "lastUpdateTimestamp": 1652429236616, "createdBy": 153169, "entityName": "taskCategory", "creationTimestamp": 1652429236616, "tenantId": 886, "subCategoryList": [ { "appName": "isdp-task-server", "category": "a2", "createdBy": 391001, "createName": "杨xx改名2", "creationDate": "2023-10-26T12:43:12.000+00:00", "creationTimestamp": 1698324192363, "deleteFlag": 0, "entityName": "TaskCategory", "id": 586248, "industry": "", "isEnable": 1, "lastUpdateDate": "2023-10-26T12:43:12.000+00:00", "lastUpdatedBy": 391001, "lastUpdateName": "杨xx改名2", "lastUpdateTimestamp": 1698324192363, "orderNum": "5", "parentId": 3548, "tenantId": 886 } ], "lastUpdateName": "lyl09", "id": 3548, "category": "学科", "createName": "lyl09" } ] }

响应示例 { "data": [ { "administrativeRegion": "sp-002", "adminOrganizationCode": "833", "adminOrganizationName": "中国区11112223333", "appName": "isdp-qc-server", "city": "", "country": "sp-002", "countryId": 898490, "createdBy": 467848, "createName": "呵呵", "creationDate": "2022-09-01T03:34:51.000+00:00", "creationTimestamp": 1662003291074, "deliveryScene": "333333", "docFileId": 7023559, "docFileName": "qq_2689.xlsx", "docNameRule": "4;9", "docType": 0, "docUdf1": "", "docUdf2": "", "entityName": "docTemplate", "isDeleteSheet": 0, "isGenerateDoc": 1, "isPictureShowMode": 1, "isThumbnailOutput": 0, "isWaterMarkOutput": 0, "lastUpdateDate": "2022-09-02T12:26:50.000+00:00", "lastUpdatedBy": 756277, "lastUpdateName": "圈圈", "lastUpdateTimestamp": 1662121610597, "locationType": "", "naSource": "1", "orgPath": "-1.830.833", "originalTemplateId": 249356, "productType": "", "province": "", "qcTemplateCode": "QC202XXXXXXXXXXXXXX", "qcTemplateId": 249356, "qcTemplateName": "42", "qcTemplateVerson": "1.0", "remarks": "ss", "reportPicture": "", "serviceType": "作业1", "status": 1, "templateCode": "DOCT-202209011074", "templateId": 117045415581, "templateName": "sss2222", "tenantId": 886, "type": 1 }, { "administrativeRegion": "", "adminOrganizationCode": "833", "adminOrganizationName": "中国区11112223333", "appName": "isdp-qc-server", "city": "", "country": "", "createdBy": 467848, "createName": "呵呵", "creationDate": "2022-07-19T04:37:04.000+00:00", "creationTimestamp": 1658205424302, "deliveryScene": "1", "docFileId": 6785120, "docFileName": "报告333.xlsx", "docNameRule": "4;9", "docType": 0, "docUdf1": "", "docUdf2": "", "entityName": "docTemplate", "isDeleteSheet": 0, "isGenerateDoc": 1, "isPictureShowMode": 1, "isThumbnailOutput": 0, "isWaterMarkOutput": 0, "lastUpdateDate": "2022-07-19T04:37:04.000+00:00", "lastUpdatedBy": 467848, "lastUpdateName": "呵呵", "lastUpdateTimestamp": 1658205424302, "locationType": "", "naSource": "", "orgPath": "-1.830.833", "originalTemplateId": 165211, "productType": "dfsgdfgsdfgdf;dfgdfg", "province": "", "qcTemplateCode": "QC202XXXXXXXXXXXXXX", "qcTemplateId": 165211, "qcTemplateName": "签名录音", "qcTemplateVerson": "1.0", "remarks": "", "reportPicture": "Y", "serviceType": "质量检查", "status": 1, "templateCode": "DOCT-202207194302", "templateId": 117045415443, "templateName": "是是是111", "tenantId": 886, "type": 1 } ], "pos": 15, "total_count": 1402, "entityName": null, "totalCount": 1402 }

请求参数 参数 类型 是否必填 描述 page PageRequest 否 分页对象 sceneId Long 否 场景ID createName String 否 创建人名字 adminOrganizationCode String 否 组织单元编码 status String 否 模板状态 0草稿 1可用 2不可用 3已删除 Page参数 参数 类型 是否必填 描述 start Integer 否 分页起始下标 (从0开始) count Integer 否 查询总条数（最大查询100条）

响应参数 参数 类型 描述 stateCode String 响应状态码： 0-成功 其他-失败 errorMessage String 响应描述 result Object 响应结果内容data、分页数据 result: 参数 类型 描述 administrativeRegion String 行政区域 adminOrganizationCode String 行政组织编码 adminOrganizationName String 行政组织名称 appName String 应用名称 city Long 市ID country Long 国家ID createdBy Long 创建人 createName String 创建人名称 creationDate Date 创建时间 creationTimestamp Long 创建时间戳 deliveryScene String 设置交付场景 docFileId Long 静态模板id docFileName String 静态模板名称 docNameRule String 文档名称规则 docType Integer 报告生成方式 docUdf1 String 文档名称自定义1 docUdf2 String 文档名称自定义2 entityName String 实体名称 isDeleteSheet Integer 自动删除空白页签 isGenerateDoc Integer 是否自动生成报告 isPictureShowMode Integer 图片平铺模式 isThumbnailOutput Integer 是否缩略图输出 isWaterMarkOutput Integer 是否水印输出 lastUpdateDate Date 最近更新日期 lastUpdatedBy Long 最近更新人 lastUpdateName String 最近更新人名称 lastUpdateTimestamp Long 最近更新时间戳 locationType String 位置类型 naSource String NA结果自适应(采集NA:1;评审NA：2) orgPath String 组织单元路径 originalTemplateId Long 源作业模板id productType String 产品类别 province Long 省ID qcTemplateCode String 作业模板编码 qcTemplateId Long 作业模板id qcTemplateName String 设置作业模板名字 qcTemplateVerson String 版本号 remarks String 备注 reportPicture String 报告图片 serviceType String 业务类型 status Integer 模板状态 0草稿 1可用 2不可用 3已删除 templateCode String 模板编码 templateId Long 模板ID templateName String 模板名称 tenantId Long 租户ID type Integer 设置业务单类型

响应示例 { "result": [ { "content": "测试一下", "creationTimestamp": 1663141848000, "instructionId": 912, "isdpDeviceList": [ { "instructionId": 912, "userId": 1823, "userName": "张三" } ], "lastUpdateTimestamp": 1663141848000, "status": 1, "type": 1 } ], "stateCode": "0" }

响应参数 参数 类型 描述 result Object 响应消息体 errorMessage String 错误信息，接口错误时有值，正常调用时为空 stateCode String 响应状态，“0”成功 其他值失败 result 对象出参说明 参数 类型 描述 instructionId Long 指令ID type Int 指令类型:1-播报;2-播报+视频;3-播报+拍照;4-播报+录音;5-播报+直播 content String 播报内容 status Int 状态 1初始状态 2已完成 3超期 creationTimestamp Long 指令创建时间 isdpDeviceList Object 设备使用人集合 isdpDeviceList 对象出参说明 参数 类型 描述 isdpDeviceId Long 设备id

响应参数 参数 类型 描述 positionId Long 岗位id positionCode String 岗位编码 positionName String 岗位名称 orgId Long 组织单元id orgName String 组织单元名称 orgNo String 组织单元编号 positionFactor String 岗位系数 pos Integer 起始条目位置 total_count Integer 返回条目总数 entityName String 实体名称 totalCount Integer 返回条目总数 rolesList array 角色列表 rolesList说明： 参数 类型 描述 roleId Long 角色id roleNo String 角色编码 roleName String 角色名称

响应示例 { "data": [ { "positionId": 112884, "positionCode": "testwyg1", "positionName": "testwyg1", "orgId": 99007258, "orgName": "testwyg1", "orgNo": "testwyg1", "positionFactor": "1.00", "rolesList": [ { "roleNo": "Admin", "roleId": 1571341, "roleName": "Admin" } ] } ], "pos": 0, "total_count": 1, "entityName": null, "totalCount": 1 }