Skip to main content
POST
查看会话详情

授权

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,取自 POST /safari/session/list 返回的列表。

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

响应

成功

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
必填

本次请求的唯一 ID,与 Flashcat-Request-Id 响应头一致。反馈问题时请携带该 ID。

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

error
object

响应结构中的错误 payload,仅在非 2xx 响应时出现。

data
object

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