跳轉到主要內容
GET
https://api.pathors.com
/
project
/
{projectId}
/
session
/
{sessionId}
查詢會話
curl --request GET \
  --url https://api.pathors.com/project/{projectId}/session/{sessionId} \
  --header 'Authorization: <authorization>'
{
  "sessionId": "<string>",
  "state": {}
}
查詢現有會話以取得其資料,包括變數和對話歷史記錄。

基礎 URL

https://api.pathors.com

查詢會話

GET /project/{projectId}/session/{sessionId}

路徑參數

projectId
string
必填
您的專案 ID
sessionId
string
必填
要查詢的會話唯一識別符

請求標頭

Authorization
string
必填
使用您的 API 金鑰進行 Bearer 令牌認證

回應

sessionId
string
會話 ID
state
object
包含變數、訊息和其他執行狀態資訊的會話狀態

範例

請求

curl -X GET https://api.pathors.com/project/{projectId}/session/user-123-session-456 \
  --header 'Authorization: Bearer <token>'

回應

{
  "sessionId": "user-123-session-456",
  "state": {
    "variables": {
      "userName": "王小明",
      "userRole": "admin"
    },
    "messages": [
      {
        "role": "user",
        "content": "你好"
      },
      {
        "role": "assistant",
        "content": "您好!有什麼可以幫助您的嗎?"
      }
    ]
  }
}

使用說明

  • 會話 ID: 使用透過建立會話端點建立的相同會話 ID
  • 狀態結構: state 欄位包含會話執行狀態,包括變數和對話歷史記錄

錯誤回應

狀態碼描述
400缺少 projectId 或 sessionId
401無效的認證
404找不到會話
500內部伺服器錯誤
錯誤回應範例: 404 找不到:
{
  "error": "Session not found"
}
401 身份驗證失敗:
{
  "error": {
    "message": "Invalid authentication"
  }
}

相關 API