# 查询消息部件列表

`GET` `/api/session/message-parts`

不传view或传full：按partId升序返回完整部件数组，保留存量行为。传summary：按partId倒序分页返回摘要对象，不包含正文、参数、输出及Token统计。摘要模式每页最多扫描pageSize条候选，过滤SUMMARY、SUBAGENT_NOTIFICATION及hidden工具；items可能为空，请按hasMore和nextBeforePartId翻页。普通会话与子会话均校验主体归属。API调用须传X-Principal-Id，页面调用使用登录身份。

## 请求参数

### 请求头参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| X-Principal-Id | integer | 否 | 身份主体ID（Long类型）。通过API访问时必须传递以标识操作主体；通过页面访问时无需传递。可通过「身份主体」模块的创建接口获取。 |

### Query 参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| messageId | integer | 是 | 消息ID，必须属于当前主体 |
| view | string | 否 | 读取模式：full完整数组（默认）、summary轻量分页对象 |
| beforePartId | integer | 否 | 仅summary使用；上一页nextBeforePartId，首次不传 |
| pageSize | integer | 否 | 仅summary使用；每页扫描候选上限1至50，默认30 |

## 响应

### 200


### 400

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | object | 响应数据 |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |

### 500

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | object | 响应数据 |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |