# 获取文档节点原文

`GET` `/api/knowledge/document/nodeContent`

按 nodeIds 批量提取指定文档语义树节点的原文正文内容。node_id 取自 knowledgeDocumentGetTree 返回的真实节点ID（4位数字，如 0001）；API Key / OpenAPI 调用可读整个应用空间（X-App-Id）内知识库的文档，用户控制台调用可读该用户自己创建的知识库的文档，越出范围返回 403；同时校验文档归属该知识库；单次最多 50 个节点，超限报错；未命中的节点返回 status=not_found 占位。

## 请求参数

### 请求头参数

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

### Query 参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| libraryId | integer | 是 | 知识库ID |
| documentId | integer | 是 | 文档ID |
| nodeIds | array | 是 | 节点ID列表（重复query参，如 &nodeIds=0001&nodeIds=0002），最多50个 |

## 响应

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