Skip to main content
POST
搜尋會話
已棄用。 此端點已棄用,將於 2026-07-11 下架。在此之前仍可使用。請改用 V1 路徑—完整的新舊路徑對照見遷移指南
在所有會話中搜尋,根據會話資料中的字串內容尋找匹配項目。

基礎 URL

搜尋會話

路徑參數

string
必填
您的專案 ID

請求標頭

string
必填
使用您的 Project API Key(以 sk_ 開頭)進行 Bearer 令牌認證。格式:Bearer {your-api-key}

請求主體

string
必填
要在會話資料中搜尋的字串。這將匹配所有會話內容,包括變數、訊息和其他儲存的資訊。
number
要返回的最大結果數。預設值:50
number
分頁時要跳過的結果數。預設值:0

回應

array
匹配的會話陣列,按最近更新時間排序
object
分頁資訊

範例

請求

回應

使用說明

  • 搜尋字串: 搜尋區分大小寫,並匹配會話資料的整個 JSON 內容
  • 排序: 結果按 updatedAt 降冪排序(最新的在前)
  • 分頁: 使用 limitoffset 來分頁瀏覽大量結果集
  • 效能: 對於大型資料集,建議使用更具體的搜尋字串以提高查詢效能

錯誤回應

錯誤回應範例: 400 請求錯誤:
401 身份驗證失敗:

相關 API