以下是使用 Postman 实现该 GET 请求下载文件的详细步骤:
—### 步骤 1:创建新请求1. 打开 Postman,点击左上角 New -> HTTP Request。2. 在弹出的窗口中,输入请求名称(如 Download Document
),然后点击 Save。—### 步骤 2:配置请求方法、URL 和路径参数1. 方法选择:在下拉框中选择 GET。2. 输入 URL: - 格式:http://{address}/api/v1/datasets/{dataset_id}/documents/{document_id}
- 替换占位符: - {address}
:服务器地址(如 localhost:80
或 api.example.com
)。 - {dataset_id}
:实际数据集 ID(如 7898da028a0511efbf750242ac1220005
)。 - {document_id}
:实际文档 ID(如 doc-12345
)。 - 示例: plaintext http://localhost:80/api/v1/datasets/7898da02.../documents/doc-12345
—### **步骤 3:设置认证头(Authorization Header)**1. 切换到 Headers 标签页。2. 添加键值对: - Key: Authorization
- Value: Bearer <YOUR_API_KEY>
(替换 <YOUR_API_KEY>
为你的实际 API 密钥)。—### 步骤 4:发送请求并保存文件1. 点击 Send 发送请求。2. 成功响应: - 如果返回文本内容(如 This is a test...
),点击响应下方的 Save Response 按钮。 - 选择保存路径,输入文件名(如 ragflow.txt
),点击 Save。3. 失败响应: - 若返回 JSON 错误(如 "code": 102
),检查: - API 密钥是否有效。 - dataset_id
和 document_id
是否正确。 - 是否拥有该数据集权限。—### 完整配置图示| 配置项 | 值示例 ||----------------|---------------------------------------------------------------------------|| Method | GET
|| URL | http://localhost:80/api/v1/datasets/7898da02.../documents/doc-12345
|| Headers | Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
|—### 常见问题排查1. 404 Not Found: - 检查 URL 中的 dataset_id
和 document_id
是否有效。 - 确保服务器地址({address}
)正确且服务正在运行。2. 401 Unauthorized: - 确认 Authorization
头的格式正确(Bearer
+ 空格 + API 密钥)。 - 确保 API 密钥未过期且有权限访问该资源。3. 500 Internal Server Error: - 联系 API 提供方检查服务端日志。—通过以上步骤,你可以在 Postman 中成功调用该接口下载文件!