GET
/
api
/
knowledgebases
/
{knowledgebaseId}
/
datasets
取得知識庫中的資料集
curl --request GET \
  --url https://app.pathors.com/api/knowledgebases/{knowledgebaseId}/datasets \
  --header 'x-api-key: <x-api-key>'
{
  "id": "<string>",
  "filename": "<string>",
  "fileUrl": "<string>",
  "extensionType": "<string>",
  "size": 123,
  "isParsed": true,
  "createdAt": "<string>",
  "updatedAt": "<string>"
}

​
取得知識庫中的資料集

檢索屬於指定知識庫的所有資料集。

​
端點

GET /api/knowledgebases/{knowledgebaseId}/datasets

​
路徑參數

​
knowledgebaseId
string
required
要從中檢索資料集的知識庫的唯一標識符

​
請求標頭

​
x-api-key
string
required
您的專案API金鑰用於身份驗證
請求範例: 
curl -X GET \
  -H "x-api-key: your_api_key" \
  https://your-domain.com/api/knowledgebases/kb_abc123/datasets

​
回應

返回屬於指定知識庫的資料集陣列。
​
id
string
資料集的唯一標識符
​
filename
string
上傳資料集的原始檔案名稱
​
fileUrl
string
下載原始檔案的URL
​
extensionType
string
資料集的檔案副檔名
​
size
number
檔案大小（位元組）
​
isParsed
boolean
資料集是否已處理並嵌入
​
createdAt
string
資料集建立時的ISO時間戳記
​
updatedAt
string
資料集最後更新時的ISO時間戳記
回應範例: 
[
  {
    "id": "dataset_abc123",
    "filename": "company-handbook.pdf",
    "fileUrl": "https://your-domain.com/api/datasets/dataset_abc123.pdf",
    "extensionType": "pdf",
    "size": 2048000,
    "isParsed": true,
    "createdAt": "2024-01-15T10:30:00Z",
    "updatedAt": "2024-01-15T10:35:00Z"
  }
]

​
錯誤回應

狀態碼描述
400缺少知識庫ID
401無效的API金鑰
404知識庫未找到或存取被拒絕
500內部伺服器錯誤

​
回應詳情

​
處理狀態

  • isParsed: true - 資料集已完全處理並可用於搜尋
  • isParsed: false - 資料集仍在背景處理中

​
檔案存取

  • 使用 fileUrl 下載原始上傳的檔案
  • URL包含資料集ID和檔案副檔名
  • 檔案以適當的內容類型提供

​
使用說明

  • 僅返回屬於指定知識庫的資料集
  • 知識庫必須屬於您的專案（透過API金鑰驗證）
  • 結果按建立日期排序（最新的在前）
  • 處理狀態幫助追蹤哪些資料集已準備就緒可供使用

​
從舊端點遷移

如果您正在從已棄用的 /api/datasets 端點遷移:
  1. 首先，使用取得知識庫取得您的知識庫ID
  2. 更新您的API呼叫以在URL路徑中包含知識庫ID
  3. 回應格式保持不變

​
相關端點