
# 下载座席技能变更详单索引
#### 场景描述
下载座座席技能变更详单索引压缩包zip文件（yyyymmdd_ responseId），可查看每个zip包对应的座席技能变更详单（yyyymmddhhmmssSSS+3位随机数_agentSkillInfo.csv）。
#### 使用说明
- 前提条件
  - 已调用"生成座席技能变更详单索引"在后台生成文件。
  
  - 已通过鉴权（Authorization）、获得接入地址。
   
- 使用限制 开发者只能下载自己帐号下的文件，开发者帐号（appId）和数据记录文件名称（agentOprInfoFileName）必须对应。
  开发者账号（appId）包含在鉴权认证字符串中，详见[C2 监控/系统外呼/话单/知识库类接口鉴权方式](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0003.html#ZH-CN_TOPIC_0000002481273406)。
  
 
#### 接口方法
POST
#### 接口URI
https://ip:port/CCFS/resource/ccfs/downloadAgentSkillInfoFile
其中，ip为CC-FS安装的服务器IP地址，port为CC-FS的HTTPS端口号。
如果经过NSLB路由，ip为NSLB的服务器IP地址，port为CC-FS服务在NSLB映射的HTTPS端口号。
#### 请求说明
表1请求Headers参数说明 
| 序号 | 名称            | 参数类型   | 是否必选 | 默认值 | 说明                                                                                                                            |
|:---|:---|:---|:---|:---|:---|
| 1  | Content-Type  | String | True | 无   | 固定填 application/json;charset=UTF-8。                                                                                           |
| 2  | Authorization | String | True | 无   | 生成方式参见[C2 监控/系统外呼/话单/知识库类接口鉴权方式](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0003.html#ZH-CN_TOPIC_0000002481273406)。 |
   
表2请求参数说明 
| 序号 | 名称                     | 参数类型   | 是否必选 | 默认值 | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
|:---|:---|:---|:---|:---|:---|
| 1  | agentSkillInfoFileName | String | True | 无   | 座席技能变更详单索引文件名称。 调用"座席技能详单索引"接口获取。 格式：yyyyMMdd_{responseId}.zip。 例如： 调用生成座席技能变更详单索引接口的日期为2023-04-06 获取到的responseId为9239cb50a8384bb0ab503441bf089446 则该参数值为20230406_9239cb50a8384bb0ab503441bf089446.zip |
   
#### 响应说明
当调用本接口响应成功，则从httpresponse消息中获取文件的二进制数据生成话单文件。文件后缀名为.zip，文件中各参数定义参考座席技能变更详单索引文件定义，响应中content-type字段为Application/Octet-stream;charset=UTF-8。
当调用本接口响应失败，则返回相应的错误码信息。
表3响应消息参数说明 
| 序号 | 名称         | 参数类型   | 说明                                                                                                                                                                                                                                                                                                                                      |
|:---|:---|:---|:---|
| 1  | resultCode | String | 请求返回的结果码 0：成功 非0：[错误码参考](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0835.html#ZH-CN_TOPIC_0000002481113938)。 |
| 2  | resultDesc | String | 请求结果描述。                                                                                                                                                                                                                                                                                                                                 |
| 3  | resultData | Object | 请求响应数据。                                                                                                                                                                                                                                                                                                                                 |
   
#### 报文样例
- 请求头
  ```
  POST /CCFS/resource/ccfs/ivr/deleteFile  HTTP/1.1
  Authorization: auth-v2/ak/2021-08-31T09:38:50.872Z/content-length;content-type;host/c12f0ed0******************941bdd106
  Accept: */*
  Content-Type: application/json;charset=UTF-8
  Content-Length: 193
  ```
  
- 请求参数
  ```
  {
      "request": {
          "version": "2.0"
      },
      "msgBody": {
          "agentSkillInfoFileName": "20180702_9239cb50a8384bb0ab503441bf089446.zip"
      }
  }
  ```
  
- 响应参数
  ```
  {
      "resultData": null,
      "resultCode": "0",
      "resultDesc": "success"
  }
  ```
  
 
