文档列表

获取当前 RAG 知识库下的所有文档。结果通常按上传时间倒序返回。

Try It

GET/documents/documentshttps://api-platform.ope.ai

认证

使用 Bearer Token 认证。

• Header：Authorization: Bearer <token>
• 示例：Authorization: Bearer sk-xxxxxx

查询参数

无需传查询参数。

请求示例

cURL

curl -X GET "https://api-platform.ope.ai/documents/documents" \
  -H "Authorization: Bearer $OPEAI_API_KEY"

JavaScript

const res = await fetch("https://api-platform.ope.ai/documents/documents", {
  headers: {
    Authorization: `Bearer ${process.env.OPEAI_API_KEY}`,
  },
});

console.log(await res.json());

响应示例

{
  "documents": [
    {
      "doc_id": "doc_1",
      "filename": "handbook.pdf",
      "upload_time": "2026-05-09T12:00:00Z",
      "chunk_count": 18,
      "status": "success",
      "filepath": "/data/uploads/tenant_1/handbook.pdf"
    }
  ]
}

错误响应

状态码	场景	说明
401	鉴权失败	API Key 缺失、无效或权限不足
422	参数校验失败	请求格式不正确
500	查询失败	数据库查询失败