GET
/
api
/
project
/
{projectId}
/
integration
/
api
/
session
/
{sessionId}
查詢會話
curl --request GET \
  --url https://app.pathors.com/api/project/{projectId}/integration/api/session/{sessionId} \
  --header 'Authorization: <authorization>'
{
  "sessionId": "<string>",
  "data": {},
  "createdAt": "<string>",
  "updatedAt": "<string>"
}
查詢現有會話以取得其資料,包括變數和對話歷史記錄。

查詢會話

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

路徑參數

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

請求標頭

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

回應

sessionId
string
會話 ID
data
object
包含變數、訊息和其他會話資訊的會話資料
createdAt
string
會話建立時的 ISO 8601 時間戳記
updatedAt
string
會話最後更新時的 ISO 8601 時間戳記

範例

請求

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

回應

{
  "sessionId": "user-123-session-456",
  "data": {
    "variables": {
      "userName": "王小明",
      "userRole": "admin"
    },
    "messages": [
      {
        "role": "user",
        "content": "你好"
      },
      {
        "role": "assistant",
        "content": "您好!有什麼可以幫助您的嗎?"
      }
    ]
  },
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-15T10:35:00.000Z"
}

使用說明

  • 會話 ID: 使用透過建立會話端點建立的相同會話 ID
  • 資料結構: data 欄位包含所有會話資訊,包括變數和對話歷史記錄
  • 時間戳記: 所有時間戳記均為 ISO 8601 格式(UTC)

錯誤回應

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

相關 API