
# 查看智能总结 - IgetSummaryResult
#### 功能介绍
查看智能总结结果，包含全文摘要、分段总结和大纲总结
#### 授权信息
当前API调用无需身份策略权限。
#### URI
GET /koodrive/ose/v1/summary
表1Query参数 
| 参数       | 是否必选 | 参数类型   | 描述                    |
|:---|:---|:---|:---|
| fileId   | 是    | String | 文件id                  |
| language | 否    | String | 语言，cn为中文，en为英文，不传默认中文 |
   
#### 请求参数
表2请求Header参数 
| 参数            | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                     |
|:---|:---|:---|:---|
| Authorization | 是    | String | 鉴权头                                                                                                                                                                                                                    |
| X-Date        | 是    | String | 参数解释：签名时间，用于appId鉴权 约束限制：距当前时间15分钟以内，不能晚于当前时间 取值范围：日期格式，yyyMMdd'T'HHmmss'Z'，例：20251103T070140Z 默认取值：不涉及 |
| X-User-Id     | 是    | String | 用户id，不用于appId鉴权                                                                                                                                                                                                        |
| language      | 否    | String | 国际化语言标识，符合i18n规范，如zh-CN表示简体中文，en-US表示美式英语，不传默认美式英语                                                                                                                                                                     |
| X-AIUser-Id   | 否    | String | 用户id，用于appId鉴权，与X-User-Id必选其一，都存在时以X-AIUser-Id的值为准                                                                                                                                                                     |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数   | 参数类型                                                           | 描述   |
|:---|:---|:---|
| code | String                                                         | 状态码  |
| msg  | String                                                         | 状态描述 |
| data | [SummaryInfo] object | 总结信息 |
   
 表4SummaryInfo 
| 参数             | 参数类型                                                                                   | 描述   |
|:---|:---|:---|
| totalSummary   | String                                                                                 | 全文概要 |
| segmentSummary | Array of [SegmentSummaryInfo] objects | 分段总结 |
| outlineSummary | Array of [OutlineSummaryInfo] objects | 大纲总结 |
   
 表5SegmentSummaryInfo 
| 参数        | 参数类型   | 描述              |
|:---|:---|:---|
| title     | String | 段落标题            |
| startTime | String | 开始时间，格式 小时:分钟:秒 |
| summary   | String | 总结内容            |
   
 表6OutlineSummaryInfo 
| 参数        | 参数类型                                                                                   | 描述   |
|:---|:---|:---|
| outlineId | String                                                                                 | 大纲id |
| summary   | String                                                                                 | 总结内容 |
| children  | Array of [OutlineSummaryInfo] objects | 子节点  |
   
**状态码：401**
表7响应Body参数 
| 参数   | 参数类型   | 描述   |
|:---|:---|:---|
| code | String | 状态码  |
| msg  | String | 状态描述 |
   
#### 请求示例
任务FkZRfL8O112ziUy\*\*\*\*\*\*\*\*\*\*\*\*wQ-pfN6Bs对应的总结信息
```
/koodrive/ose/v1/summary?fileId=FkZRfL8O112ziUy************wQ-pfN6Bs&language=en
Authorization:Bearer+10f88*********4791e9ff
```
#### 响应示例
**状态码：200**
查看智能总结结果响应
```
{
  "data" : {
    "segmentSummary" : [ {
      "title" : "Birthday party and friendship confirmation",
      "startTime" : "00:00:00",
      "summary" : "The speaker mentioned the upcoming birthday party several times and drew a map, to which the other person responded that they would attend. The two expressed that they were each other's only friend, showing a deep friendship."
    } ],
    "totalSummary" : "The two confirmed their only friendship through a discussion about the birthday party.",
    "outlineSummary" : [ {
      "outlineId" : "0",
      "summary" : "Birthday party and friendship confirmation",
      "children" : [ {
        "outlineId" : "1",
        "summary" : "Plan a birthday party",
        "children" : [ {
          "outlineId" : "2",
          "summary" : "The speaker mentioned several times the preparation of the birthday party and the drawing of the map."
        }, {
          "outlineId" : "3",
          "summary" : "The other party confirmed that they would attend the party."
        } ]
      }, {
        "outlineId" : "4",
        "summary" : "Expressions of friendship",
        "children" : [ {
          "outlineId" : "5",
          "summary" : "The two confirmed that they were each other's only friends."
        }, {
          "outlineId" : "6",
          "summary" : "Through communication, we show deep friendship."
        } ]
      } ]
    } ]
  },
  "code" : 0,
  "msg" : "Success."
}
```
#### 状态码
| 状态码 | 描述         |
|:---|:---|
| 200 | 查看智能总结结果响应 |
| 401 | 鉴权失效       |
   
