Skip to main content
GET
获取数据源文件列表

Authorizations

Authorization
string
header
required

每个请求都通过 API Key 认证:Authorization: Bearer {API_KEY}。应用接口使用应用 API Key,知识库接口使用知识库 API Key(快速开始)。

API Key 应保存在服务端,切勿嵌入客户端代码。缺失或无效的 Key 会返回 HTTP 401(unauthorized)。

Path Parameters

knowledge_base_id
string<uuid>
required

知识库 ID:即知识库 API 访问 对话框中所示服务 API 端点的最后一段(…/knowledge-fs/spaces/<knowledge base ID>),也是地址栏中 /datasets/new/ 之后的那一段。

source_id
string<uuid>
required

数据源 ID,通过 获取数据源列表 获取。

Query Parameters

bucket
string

要浏览的存储桶,使用提供商给出的名称。省略时使用数据源上配置的存储桶。

prefix
string

要打开文件夹,将返回的 id 作为 prefix 发送。不要发送显示名称,也不要自行拼接路径。省略此参数时,从数据源配置的起始位置开始。

continuationToken
string

上一次响应中某个存储桶的 continuation_token。保持 prefix 和存储桶选择不变。如果未指定存储桶,且响应中的 bucket 为 null,省略 bucket 参数。

Required string length: 1 - 4096
maxKeys
integer

每次响应中每个存储桶返回的文件数。省略时使用数据源上配置的值;未配置时为 20。

Required range: 1 <= x <= 1000

Response

存储桶及其中的文件。

buckets
object[]

响应中的存储桶。