Skip to main content
POST
查看会话详情

限制说明

使用说明

  • 个人会话仅创建者可读;团队会话允许同一账户内持有 session_id 的调用者读取。
  • 使用上一次响应的 search_after_ctx 翻阅更早的历史。
  • limit(或旧版 num_recent_events)限制事件页大小;默认 100,最大 1000。
  • 格式错误的 search_after_ctx 会在触发任何数据库查询前立即返回 400。
  • current_turn_* 字段仅在会话 is_running 时才会填充;suggest_initsession/list 使用同一个账户级引导提示。

授权

app_key
string
query
必填

App key issued from the Flashduty console. Required on every public API call. Keep it secret — it grants the same access as the owning account.

请求体

application/json

查询单个会话,并返回其最近事件的一页(向更早方向分页)。

session_id
string
必填

目标会话 ID。

Minimum string length: 1
share_token
string

通过分享链接访问会话时使用的分享令牌;常规账户授权访问时省略。

Maximum string length: 512
num_recent_events
integer

旧版每页数量:返回的最近事件数。与 limit 同时设置时以 limit 为准;0 使用服务端默认值(100)。

必填范围: 0 <= x <= 1000
limit
integer

事件每页数量;优先于 num_recent_events。0 使用服务端默认值(100)。

必填范围: 0 <= x <= 1000
search_after_ctx
string

上一次响应返回的不透明游标;回传以获取更早的一页。

Maximum string length: 4096

响应

Success

Standard response envelope used by every Flashduty public API. On success data contains the endpoint-specific payload and error is absent. On failure error is present and data is absent. request_id is always present and is also mirrored in the Flashcat-Request-Id response header.

request_id
string
必填

Unique ID for this request. Mirrored in the Flashcat-Request-Id header. Include it when reporting issues.

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

error
object

Error payload inside the response envelope. Present only on non-2xx responses.

data
object

一个会话及其事件的一页(向更早方向分页)。