Skip to main content
DELETE
結束會話
已棄用。 此端點已棄用,將於 2026-07-11 下架。在此之前仍可使用。請改用 V1 路徑—完整的新舊路徑對照見遷移指南
當對話完成時結束現有會話。這對於資源清理和管理很有用。

基礎 URL

結束會話

路徑參數

string
必填
您的專案 ID

請求標頭

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

請求內容

string
必填
要結束的會話的唯一識別符

回應

boolean
指示會話是否成功結束
string
已結束會話的 ID
string
會話已結束的確認訊息

範例

請求

回應

使用說明

  • 資源清理: 結束會話有助於釋放伺服器資源,應該在對話完成時執行
  • 會話變數: 當會話結束時,所有會話變數和對話上下文都將被永久刪除
  • 會話管理: API將嘗試結束指定的會話。無論會話是否處於活躍狀態,都會回傳成功回應

錯誤回應

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

最佳實踐

  1. 始終結束會話: 在對話完成時結束會話以防止資源洩漏
  2. 錯誤處理: 優雅地處理錯誤並為失敗的請求實施適當的重試邏輯
  3. 會話追蹤: 在您的應用程式中追蹤活躍的會話 ID,以便正確管理它們