Skip to main content
GET
/
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 https://api.pathors.com/project/{projectId}/session/{sessionId}

路径参数

projectId
string
required
您的项目 ID
sessionId
string
required
要查询的会话唯一标识符

请求头

Authorization
string
required
使用您的 Project API Key(以 sk_ 开头)进行 Bearer 令牌认证。格式:Bearer {your-api-key}

响应

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