# 获取文档语义树

`GET` `/api/knowledge/document/tree`

获取指定文档的完整语义树节点结构，包含每个节点的标题、层级、摘要、原文片段引用等。只能读取当前调用方可见范围内的文档：API Key / OpenAPI 调用可读整个应用空间（X-App-Id）内知识库的文档，用户控制台调用可读该用户自己创建的知识库的文档；文档不存在或越出范围均返回 403（两者不可区分，避免泄露文档是否存在）。语义树由 dianjin-agent 内核异步生成，若文档尚处于解析状态会返回空结构；前端应根据状态字段做空态展示。

## 请求参数

### Query 参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| documentId | integer | 是 | 文档ID |
| agentId | integer | 否 | 智能体ID，仅用于应用空间授权只读知识库 |

## 响应

### 200

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

### 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处理 |