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