华为云用户手册

报文样例 场景描述：录音文件转文本 请求头: x-app-key:************************************ Authorization:Bearer ************************************ 请求参数: {"language": "zh_CN","voiceFilePath": "Y:\\27\\0\\20210201\\1118\\0951044.V3","agentId": 1118,"beginTime": "2021-02-01 09:51:07","endTime": "2021-02-01 09:57:57"} 响应参数: { "resultCode": "1010200","resultDesc": "success","taskId": "608ba63d00000982","duration": "20",}

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string False 固定填 application/json; charset=UTF-8。 2 x-app-key string False appKey标识，请联系运营人员获取 3 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 language string True 录音文件语言（zh_CN 代表中文，en_US 代表英文） 1.2 voiceFilePath string True 录音文件路径，格式举例：F:\\22\\22\\123.V3 1.3 agentId number True 座席人员工号 1.4 beginTime string True 通话开始时间，时间格式：yyyy-MM-dd HH:mm:ss 1.5 endTime string True 通话结束时间，时间格式：yyyy-MM-dd HH:mm:ss

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 resultCode string True 响应状态码 1.2 resultDesc string True 响应状态消息 1.3 taskId string False 新建任务的ID 1.4 duration string False 音频时长，单位: 秒 响应状态码: 400 请求的内容未找到：请检查请求的路径和各参数的取值。 响应状态码: 401 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

报文样例 场景描述：新增定时抽检计划 请求头: Content-Type:application/json x-app-key:xxxx-xxxx-xxx-xxxx x-UserId:xxxxxxxxx Authorization:Bearer ******************************** 请求参数: {"extractionRange": {"customColumns": null,"fixedColumns": {"durationEnd": "100","durationStart": 1,"interactionType": 0,"maxNum": "10","qualityCondition": 2,"qualityNum": "100","qualityType": 1,"staffIds": [],"scoreStart": "0","scoreEnd": "100"},"currentRole": "qualityDirector"},"appointQuality": {"setCounts": [{"personID": "1679888547924121791","count": 0}],"setCountsType": 0},"cronStructure": {"qiqtCycleType": "1","qiqtStartTime": 1692171720,"qiqtEndType": "2","qiqtTotalTimes": 1,"qiqtEndTime": 1692258120},"qiqtName": "test082101","currentRole": "qualityDirector"} 响应头: Content-Type: application/json;charset=UTF-8 响应参数: {"objId": "954637368599307266","resultCode": 0,"resultDesc": "success"}

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string False 固定填 application/json; charset=UTF-8。 2 x-app-key string False appKey标识 3 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 4 x-UserId string True 操作员标识 可在登录后，进入员工管理页面，查看接口返回的userId 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 appointQuality object True 指派质检员 1.1.1 setCounts array[object] True 设置质检员 1.1.1.1 count number False 数量，最大长度8位 setCountsType!=2时，count必填。 setCountsType==2时，setCounts中所有count总和为100。 1.1.1.2 personID string True 质检员ID，最大长度64位 1.1.2 setCountsType integer True 设置数量的类别：0-平均分配，2-百分比 1.2 cronStructure object True 设置周期 1.2.1 qiqtCycleType string True 重复方式： 1，每天，2.每周，3.每月 1.2.2 qiqtEndTime integer False 结束时间：当qiqtEndType 为2 时有效，秒级，最大长度10位 1.2.3 qiqtEndType string True 结束条件： 1.次数 2.时间 1.2.4 qiqtStartTime integer True 开始时间，秒级，最大长度10位 1.2.5 qiqtTotalTimes integer False 定时任务执行次数，最大长度8位。 qiqtEndType==1时，qiqtTotalTimes必填。 1.3 currentRole string False 用户角色 1.4 extractionRange object True 设定抽检范围 1.4.1 currentRole string False 用户角色 1.4.2 fixedColumns object True 抽检范围条件设定 1.4.2.1 qualityType integer True 抽检类型：1.通话范围 2.座席抽检数量类型 3.座席抽检百分比类型 1.4.2.2 durationStart integer False 通话最短时间，毫秒级，最大长度11位 1.4.2.3 qualityNum string True 抽检数量，最大长度8位 1.4.2.4 qualityCondition integer True 抽检状态：0.不限制 1.未抽检 2.已抽检 1.4.2.5 durationEnd string False 通话最长时间，毫秒级，最大长度11位 1.4.2.6 maxNum string False 最大抽检量，最大长度8位。 qualityType!=2时，maxNum参数必填且参数值大于等于1。 1.4.2.7 scoreEnd string False 最高分数，最大分数10000 1.4.2.8 scoreStart string False 最低分数，最大分数10000 1.4.2.9 staffIds array[string] False 座席人员 1.4.2.10 interactionType integer True 交互类型。取值范围： 0：录音 2：文本 1.4.3 userId string False 用户ID 1.5 qiqtName string True 计划名称，最大长度64位 1.6 userId string False 用户ID

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 objId string False 抽检计划唯一标识 1.2 resultCode string False 返回码 0408000 表示成功 其他表示失败 1.3 resultDesc string False 返回描述 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string False 固定填 application/json; charset=UTF-8。 2 x-app-key string False appKey标识 3 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 4 x-UserId string False 操作员标识 可在登录后，进入员工管理页面，查看接口返回的userId 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 callGroupId number True 通话业务规则id 1.2 callId number True 通话标识id 1.3 isGroup boolean False 是否是关联通话 1.4 leaderRole string True 提交申诉领导职别 1.5 leaderUUID string True 申诉领导id 1.6 taskDescription string True 申诉原因 1.7 chooseRuleGroupList array[object] True 待申诉规则列表 1.7.1 ruleGroupId string True 规则id 1.7.2 reviseIdList array[string] True 待申诉规则列表 1.8 callType string True 文件类型、交互类型

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 status string False 状态 1.2 message string False 返回信息 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

报文样例 场景描述：发起申诉。 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: {"taskDescription": "remark","callId": "c6a31191-6c69-486b-b8f9-c3412ef44bfd","callGroupId": "c6a31191-6c69-486b-b8f9-c3412ef44bfd","isGroup": false,"chooseRuleGroupList": [{"ruleGroupId": "groupid_fa1d9f72-f961-4ad6-9277-008bbe1c3802","reviseIdList": ["silenceRule4a0e94cf-c357-4d53-9beb-4cefb2a81fb4", "silenceRule4aa85a8a-f914-4488-bf11-adbbfde3fe95"]}],"leaderUUID": "1600226359041729505","leaderRole": "10","fileName": "766"} 响应参数: {"callId": "c6a31191-6c69-486b-b8f9-c3412ef44bfd","available": true}

报文样例 场景描述：查询定时抽检计划 请求头: Content-Type:application/json x-app-key:xxxx-xxxx-xxxx-xxxx-xxxx x-UserId:xxxx Authorization:Bearer ******************************** 请求参数: {"page": 1,"rows": 10} 响应头: Content-Type: application/json;charset=UTF-8 响应参数: {"total": 2,"list": [{"qiqtStartTimeStr": "2020-12-30 10:27:08","qiqtEndType": "2","qiqtEndTypeStr": "时间限制","qiqtId": "954637368599307266","nextExecutionTimeStr": "2020-12-31 10:27:08","qiqtName": "regulartask","qiqtExecutionTimes": 0,"qiqtTotalTimes": 1,"qiqtCycleType": "每天","qiqtStatus": "2","qiqtCreater": "xxxx","qiqtCreateTimeStr": "2020-12-30 10:27:33","qiqtEndTimeStr": "2021-01-02 10:27:08", "interactionType": "0"}, {"qiqtStartTimeStr": "2020-11-23 11:30:00","qiqtEndType": "2","qiqtEndTypeStr": "时间限制","qiqtId": "933182094016018433","nextExecutionTimeStr": "2020-12-29 11:30:00","qiqtName": "long1123","qiqtExecutionTimes": 9,"qiqtTotalTimes": 1,"qiqtCycleType": "每天","qiqtStatus": "1","qiqtCreater": "xxxx","qiqtCreateTimeStr": "2020-11-23 10:22:48","qiqtEndTimeStr": "2020-12-30 10:24:50", "interactionType": "0"}],"resultCode": "0408000","resultDesc": "操作成功"}

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string False 固定填 application/json; charset=UTF-8。 2 x-app-key string False appKey标识 3 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 4 x-UserId string False 操作员标识 可在登录后，进入员工管理页面，查看接口返回的userId 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 page integer True 第几页 1.2 rows integer True 每页条数

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 total integer False 总计条数 1.2 list array[object] True 定时抽检计划列表 1.2.1 nextExecutionTimeStr number False 下次执行时间 1.2.2 qiqtCreateTimeStr number False 创建时间 1.2.3 qiqtCreater string False 创建人 1.2.4 qiqtCycleType string False 重复方式： 每天 每周 每月 1.2.5 qiqtEndTimeStr string False 结束时间：当qiq_end_type 为2 时有效 1.2.6 qiqtEndType string False 结束条件： 1.次数 2.时间 1.2.7 qiqtEndTypeStr string False 结束条件 1.2.8 qiqtExecutionTimes number False 执行次数 1.2.9 qiqtId string False 定时抽检任务ID 1.2.10 qiqtName string False 定时任务名称 1.2.11 qiqtStartTimeStr number False 开始时间 1.2.12 qiqtStatus string False 状态： 1.停止；2.运行 1.2.13 qiqtTotalTimes number False 定时任务执行次数 1.2.14 interactionType string False 质检任务类型 0表示语音类型 2表示文本类型 1.3 resultCode string False 返回码 0408000 表示成功 其他表示失败 1.4 resultDesc string False 返回描述 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

报文样例 场景描述：获取指定通话的质检结果 请求头: x-app-key:XXXXXXXXXXX Authorization:Bearer XXXXXXXXXXX 请求参数: {"call_uuid": "822bbf4d-c4f8-473a-9144-199058375be8"} 响应参数: {"staff_name": "xieyiling","left_speed": 324.068,"create_time": 1635318854,"left_speech_ratio": 0.6081,"file_name": "1111","right_speech_ratio": 0.185,"left_channel": "customer"，"call_time": 1635318854,"right_channel": "staff","call_id": "17af55af-e51d-4cc0-8a62-84222e1d1eea","segments": [{"start_time": 0.0,"asr_text": "请问是您想询价吗","speaker": "customer","end_time": 11.32,"segment_id": 1}, {"start_time": 13.36,"asr_text": "对","speaker": "staff","end_time": 13.88,"segment_id": 2}, {"start_time": 14.56,"asr_text": "那您是打算在北京这边买车是吗","speaker": "customer","end_time": 16.74,"segment_id": 3}, {"start_time": 18.74,"asr_text": "是的","speaker": "staff","end_time": 19.68,"segment_id": 4}, {"start_time": 20.28,"asr_text": "那您是打算上本地牌照吗","speaker": "customer","end_time": 23.66,"segment_id": 5}, {"start_time": 25.76,"asr_text": "北京这边可以上河北的牌照吗","speaker": "staff","end_time": 28.4,"segment_id": 6}, {"start_time": 29.24,"asr_text": "不同的城市是有不同的上牌要求的","speaker": "customer","end_time": 37.48,"segment_id": 7}, {"start_time": 38.04,"asr_text": "一会给您回电再详细介绍一下","speaker": "customer","end_time": 47.42,"segment_id": 8}, {"start_time": 49.12,"asr_text": "可以","speaker": "staff","end_time": 50.22,"segment_id": 9}, {"start_time": 51.0,"asr_text": "那您是准备在北京买车是吗","speaker": "customer","end_time": 53.22,"segment_id": 10}, {"start_time": 56.26,"asr_text": "有什么优惠吗","speaker": "staff","end_time": 62.96,"segment_id": 11}, {"start_time": 61.7,"asr_text": "嗯是这样的","speaker": "customer","end_time": 62.64,"segment_id": 12}, {"start_time": 63.74,"asr_text": "部分车型是可以零首付的","speaker": "customer","end_time": 73.28,"segment_id": 13}, {"start_time": 73.76,"asr_text": "稍后我让店里的专业顾问再给您详细介绍一下","speaker": "customer","end_time": 78.34,"segment_id": 14}, {"start_time": 80.1,"asr_text": "可以","speaker": "staff","end_time": 81.68,"segment_id": 15}, {"start_time": 82.54,"asr_text": "您什么时候方便","speaker": "customer","end_time": 85.48,"segment_id": 16}, {"start_time": 86.7,"asr_text": "随时可以","speaker": "staff","end_time": 91.28,"segment_id": 17}, {"start_time": 91.72,"asr_text": "好的","speaker": "staff","end_time": 92.04,"segment_id": 18}, {"start_time": 92.16,"asr_text": "稍后我让负责的同事跟您联系","speaker": "customer","end_time": 95.68,"segment_id": 19}, {"start_time": 93.76,"asr_text": "好吧"，"speaker": "staff","end_time": 94.04,"segment_id": 20}, {"start_time": 96.18,"asr_text": "您还有其他问题吗","speaker": "customer","end_time": 97.82,"segment_id": 21}, {"start_time": 99.52,"asr_text": "没有","speaker": "staff","end_time": 100.12,"segment_id": 22}, {"start_time": 100.68,"asr_text": "好的那我先挂机了祝您生活愉快再见","speaker": "customer","end_time": 104.12,"segment_id": 23}],"left_silence_time": 40.8,"duration": 104.12,"right_emotions": [{"score": 32.0,"type": "negative"}, {"score": 69.0,"type": "positive"}],"right_silence_time": 84.86,"upload_time": 1635318854,"left_emotions": [{"score": 65.0,"type": "negative"}, {"score": 80.0,"type": "positive"}],"right_speed": 230.53,"staff_id": "xieyiling","call_type": 0,"status": 2}

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 left_speed number False 左声道发话语速，发话方取决于left_channel字段 1.2 left_speech_ratio number False 左声道通话比例，发话方取决于left_channel字段 1.3 file_name string False 质检文件名称 1.4 left_channel string False 左声道发话方：客户，座席 1.5 right_speech_ratio number False 右声道通话比例，发话方取决于right_channel字段 1.6 call_time number False 通话开始时间 1.7 right_channel string False 右声道发话方：客户，座席 1.8 call_id number False 通话标识 1.9 left_silence_time number False 发话静音时间 1.10 segments array[object] False ASR转写文本语段结果 1.10.1 asr_text string False ASR转写文本 1.10.2 speaker number False 发话方 1.10.3 start_time number False 发话开始时间 1.10.4 end_time number False 发话结束时间 1.10.5 segment_id number False ASR转写文本语段标识 1.11 duration number False 通话时间 1.12 right_silence_time number False 发话静音时间，发话方取决于right_channel字段 1.13 upload_time number False 通话上传时间 1.14 left_emotions array[object] False 通话语气，只针对座席，取决于left_channel是否为座席 1.14.1 type string False 语气类型：积极，消极 1.14.2 score number False 语气评分 1.15 right_speed number False 右声道发话语速，发话方取决于right_channel字段 1.16 staff_id string False 座席人员的userId 可在登录后，进入座席管理页面，查看接口返回的accountId 1.17 call_uuid string False 通话标识 1.18 call_type number False 质检通话类型： 2：文本 0：音频 1.19 status string False 质检状态取值如下： 0：表示等待质检。 1：表示质检处理中。 2：表示处理成功。 3：表示ASR转写中。 9：表示质检失败，发生错误，质检音频总流量达到每日上限，质检文件数量达到每日上限。 31：表示ASR转写结果语音内容为空。 32：表示语音转文本失败。 33：表示上传语音文件至ASR失败。 34：表示科大ASR传输任务提交失败。 35：表示执行多媒体质检任务失败。 36：表示TUC质检失败。 37：表示ASR将语音文件转换为文本失败。 38：表示更新质检结果失败。 39：表示执行质检失败。 40：表示语音文件无效。 1.20 right_emotions array[object] False 通话语气，只针对座席，取决于right_channel是否为座席 1.20.1 type string False 语气类型：积极，消极 1.20.2 score number False 语气评分 1.21 staff_name string False 座席名称 1.22 create_time string False 创建时间 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string False 固定填 application/json; charset=UTF-8。 2 x-app-key string False appKey标识，请联系运营人员获取 3 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 call_uuid string True 通话标识 可从appraisecall/details接口返回的结果获取call_uuid

报文样例 场景描述：查询质检件 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: {"rows": 10000,"page": 1,"startTimeMillis": 1623318494,"endTimeMillis": 1623923294,"fixedColumns": {"agentUserIds": [],"qualityUserIds": [],"taskType": null,"taskStatus": null}} 响应参数: {"data": [{"taskType": "APPEAL","calls": [{"call_uuid": "8b595000-b02a-4290-9548-a4915001e89f"}],"initiatorName": "zxry0611","taskOperatorName": "zxzg0611","id": "16237434242323475065","taskStatus": "reviewed","createTimeStr": "2021-06-15 15:50:24","updateTimeStr": "2021-06-15 15:50:25","setting": {"file_name": "a1"}}, {"taskType": "APPEAL","calls": [{"call_uuid": "473fbc39-f231-43f4-b1d7-7fc415c6e990"}],"initiatorName": "zxry0611","taskOperatorName": "","id": "16233956459326867354","taskStatus": "processing","createTimeStr": "2021-06-11 15:14:06","updateTimeStr": "2021-06-15 15:26:00","setting": {"file_name": "a3"}}, {"taskType": "APPEAL","calls": [{"call_uuid": "473fbc39-f231-43f4-b1d7-7fc415c6e990"}],"initiatorName": "zxry0611","taskOperatorName": "zxry0611","id": "16233929966871311191","taskStatus": "end","createTimeStr": "2021-06-11 14:29:57","updateTimeStr": "2021-06-11 15:06:20","setting": {"file_name": "a3"}}]}

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 total number False 总条数 1.2 pages number False 总页数 1.3 data array[object] False 质检件数据 1.3.1 id number False 质检件标识 1.3.2 taskTypeName string False 申诉件类型名称 1.3.3 inspectorName string False 质检人员名称 1.3.4 reviewingOfficerName string False 复核人员名称 1.3.5 initiatorName string False 发起人员名称 1.3.6 taskOperatorName string False 处理人员名称 1.3.7 agentName string False 经办人名称 1.3.8 taskStatusName string False 申诉件状态名称 1.3.9 calls array[object] False 通话详情列表 1.3.9.1 call_uuid string False 通话质检标识 1.3.10 createTimeStr string False 创建时间（格式：yyyy-MM-dd） 1.3.11 updateTimeStr string False 更新时间（格式：yyyy-MM-dd） 1.3.12 setting object False 通话详情列表 1.3.12.1 file_name string False 文档名 1.4 pageSize number False 每页条数 1.5 pageNum number False 页码 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string False 固定填 application/json; charset=UTF-8。 2 x-app-key string False appKey标识 3 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 4 x-UserId string False 操作员标识 可在登录后，进入员工管理页面，查看接口返回的userId 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 fixedColumns object False 高级查询的条件 1.1.1 agentUserIds array False 座席组座席的用户ID合集 1.1.2 qualityUserIds array False 质检组质检员的用户ID合集 1.1.3 taskType string False 质检件类型（1 问题件，2 申诉件） 1.1.4 taskStatus number False 质检件状态（21:审核中，22:完结，24:处理中，27:核实中） 1.2 startTimeMillis number False 质检件开始时间，时间戳秒 1.3 endTimeMillis number False 质检件结束时间，时间戳秒 1.4 rows number False 每页条数（限制一页回传笔数，目前最大值一百万） 1.5 page number False 搜寻的页数，以1为底，一页大小由rows决定

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 消息正文的类型为JSON 2 access-token string True 用户访问租间token，参见调用鉴权接口 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1 taskInfo TaskInfo False 任务信息，该对象的参数说明请参见表3 表3 TaskInfo参数说明 序号 名称 参数类型 长度（字节） 是否必选 说明 1 id string 20 True 任务id 2 title string 128 False 任务标题 3 description string 20000 False 任务描述 4 type string - False 任务关联类型 取值： Case 5 relateId string 20 False 关联类型对应id，如果关联任务类型有值，这里也必须有值 6 contactId string 20 False 联系人id 7 priority string 128 False 优先级 dataType : SingleSelect 枚举值： Critical High Medium Low 8 dueDate Datetime - False 期望完成时间，时间格式为YYYY-MM-DD HH:mm:ss 9 attachment string 255 False 任务附件 10 creatorId string 20 False 创建人id

消息样例 场景描述：修改任务 URL：https:// 域名 /service/AICC__Case/1.0.0/openapi/task/modify 请求头: { "Content-Type": "application/json", "access-token": "0000000000************7bm63KsRmEztTvyA="} 请求体： { "taskInfo":{ "id":"ccqG0000014iXvGKONQO", "title":"show0707", "creatorId": "10gg00000148QvgpaLAm" }} 响应头： { "connection": "keep-alive", "Content-Length": "16","Content-Type": "application/json%3Bcharset=UTF-8"} 响应参数： {"resCode": "0","resMsg": "成功"}

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 total number True 总条数 1.2 data array[object] True 查询数据 1.2.1 id number False 任务ID 1.2.2 inspector string False 质检人员 1.2.3 inspectStatus number False 质检状态 1.2.4 calls array[object] False 通话列表 1.2.4.1 call_id string False 通话业务id 1.2.4.2 file_name string False 文件名称 1.2.4.3 duration number False 通话时长 1.2.4.4 upload_time number False 上传时间 1.2.4.5 call_time number False 通话开始时间 1.2.4.6 call_uuid string False 通话业务id 1.2.4.7 taskId number False 任务id 1.2.4.8 call_type number False 通话类型 1.2.4.9 inspectStatus number False 质检状态 1.2.4.10 leftChannel string False 左声道 1.2.4.11 leftSpeechRatio number False 左声道通话比例 1.2.4.12 rightSpeechRatio number False 右声道通话比例 1.2.5 setting object False 扩展信息 1.2.5.1 call_id string False 通话详情id 1.2.5.2 taskId number False 任务id 1.2.5.3 staffId string False 坐席id 1.2.5.4 staff_name string False 坐席姓名 1.2.6 inspectorName string False 抽检人员名称 1.2.7 is_group boolean False 是否关联通话 1.3 resultCode string False 返回码 0409000 表示成功 其他表示失败 1.4 resultDesc string False 返回描述 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

报文样例 场景描述：抽检任务详情。 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: {"currentRole": "qualityDirector","page": 1,"rows": 10,"fixedColumns": {"planCode": "125092321715122176","showReviewingOfficer": false,"inspectStatus": "0"}} 响应参数: {"total": 1,"pages": 0,"data": [{"calls": [{"duration": 347.16,"upload_time": 1609143922,"rightSpeechRatio": "0.2446","file_name": "766","leftSpeechRatio": "0.1933","call_time": 1609143921,"leftChannel": "staff","call_uuid": "c6a31191-6c69-486b-b8f9-c3412ef44bfd","inspectStatus": 0,"call_type": 0,"taskId": "954153162039409666","call_id": "954155173359172609"}],"id": "954153162039409666","inspector": "1600226476732482572","inspectStatus": 0,"inspectorName": "zjrylong","is_group": false,"setting": {"staff_name": "zxrylong","staffId": "1600226440112042215","taskId": "954153162039409666","call_id": "954155173359172609"}}],"resultCode": "0409000","resultDesc": "success"}

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string False 固定填 application/json; charset=UTF-8。 2 x-app-key string False appKey标识 3 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 4 x-UserId string False 操作员标识 可在登录后，进入员工管理页面，查看接口返回的userId 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 currentRole string True 用户角色： 质检主管职位：qualityDirector 质检人员职位：qualityInspector 座席人员职位：tableStaff 座席主管职位：tableDirector 1.2 page number True 分页，第几页 1.3 rows number True 分页，每页条数 1.4 fixedColumns object True 抽检任务详情 1.4.1 planCode string True 抽检任务编码，不超过128字符 1.4.2 showReviewingOfficer boolean True 搜索是否已指派复核人的任务: false-否 true-是 1.4.3 inspectStatus string False 抽检状态： -1指未抽检、 0指抽检中、 1指已抽检 1.4.4 inspector string False 抽检人员，不超过256字符 1.4.5 fileName string False 文件名称，不超过256字符 1.4.6 reviewingOfficer string False 复核人员，不超过256字符 1.4.7 reviewingStates string False 复核状态： -1指未复检 2指复检中 3指已复检 1.4.8 staff string False 座席人员，不超过256字符 1.4.9 durationFrom number False 通话时长范围开始 1.4.10 durationTo number False 通话时长范围结束

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 X-APP-Key string False appKey字段，用户标识，请联系运营人员获取appKey。 2 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格）。 生成方式参见文档C1 系统配置类接口鉴权方式式章节。 3 Content-Type string False "application/json" 表2 请求体参数 序号 参数 是否必选 类型 描述 1 requestBody [] 是 UserRoles 用户角色，支持批量处理，数组最大支持999。 1.1 actionType 是 String 操作类型： Grant：分配权限 Revoke：取消权限 1.2 userId 是 String 用户标识id。 1.3 roleId 是 String 角色标识id。

报文样例 场景描述：同步角色 URL：https://域名/apiaccess/rest/sum/v1/tenantSpaces/roles/users 请求头 x-app-key:953587d812f642998ee1f633b81212f3Authorization:Bearer e3fca9398eaa5cef4b57b523b9c75faeContent-Type:application/json 请求消息: { "requestBody": [{ "actionType": "Grant", "userId": "10gg0000015C8wfbgWbg", "roleId": "cH9k0000019M3qH6PKFM" },{ "actionType": "Grant", "userId": "10gg0000015C8wfbgWbg", "roleId": "cH9k0000019AIu9XwdHc" }]} 响应消息: { "resCode": "0", "resMsg": "success", "result": { "agentRoleId": [] }}

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 消息正文的类型为JSON 2 access-token string True 用户访问租间token，参见调用鉴权接口 表2 请求体参数 序号 名称 参数类型 长度（字节） 是否必选 说明 1 id string 20 True 任务id 2 ownerId string 20 True 被分配人id 3 creatorId string 20 True 创建人id

消息样例 场景描述：分配任务 URL：https://域名/service/AICC__Case/1.0.0/openapi/task/transfer 请求头: { "Content-Type": "application/json", "access-token": "0000000000************7bm63KsRmEztTvyA="} 请求体： { "id": "ccqG0000014iXvGKONQO", "ownerId": "10gg00000148QvgpaLAm", "creatorId": "10gg00000148QvgpaLAm"} 响应头： { "connection": "keep-alive", "Content-Length": "16","Content-Type": "application/json%3Bcharset=UTF-8"} 响应参数： {"resCode": "0","resMsg": "成功"}

消息样例 场景描述：修改工单状态 URL：https://域名/service/AICC__Case/1.0.0/openapi/status/update 请求头: { "Content-Type": "application/json", "access-token": "0000000000************7bm63KsRmEztTvyA="} 请求体： {"id": "c6m80000013uPdSDTGbY","status": "Completed","creatorId":"10gg000000sLj1ytR70C"} 响应头： { "connection": "keep-alive", "Content-Length": "16","Content-Type": "application/json%3Bcharset=UTF-8"} 响应参数： {"resCode": "0","resMsg": "成功"}

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 消息正文的类型为JSON 2 access-token string True 用户访问租间token，参见调用鉴权接口 表2 请求体参数 序号 名称 参数类型 长度（字节） 是否必选 说明 1 id string 20 True 工单id，长度为20 2 creatorId string 20 True 操作处理人id 3 status string - True 工单状态 dataType : SingleSelect 枚举值： 0.Completed(默认值) 其他值业务自定义

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 resultCode string False 返回码 0409000 表示成功 其他表示失败 1.2 resultDesc string False 返回描述 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。