跳转到主要内容
POST
查看会话详情

限制说明

使用说明

  • 个人会话仅创建者可读,或持有有效 share_token 的调用者只读访问。团队会话同一账户内的任何成员都可读。会话不存在、已删除或无权读取时返回 ResourceNotFound。
  • events 为最新的一页,按时间升序排列。如需更早的历史,把返回的 search_after_ctx 传回;游标格式错误返回 InvalidParameter。
  • 每页条数取 limit,其次 num_recent_events,都未设置时为 100(最大 1000)。内部控制事件不会返回,因此一页可能少于请求的条数。
  • current_turn_* 字段仅在 is_running 为 true 时填充。本接口中 has_unread 恒为 false、pinned_at 恒为 0;如需这两项请使用 POST /safari/session/list。
  • pending_messages 列出排在当前运行轮次之后的消息;没有排队消息时为空数组。

授权

app_key
string
query
必填

在 Flashduty 控制台 我的 → APP Key 中创建的 APP Key。可通过 query 参数 app_key 或请求头 Fd-App-Key 传入。实际可访问范围是该 APP Key 的权限范围与创建者当前角色权限的交集,请妥善保管。

请求体

application/json

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

session_id
string
必填

目标会话 ID,取自 POST /safari/session/list 返回的列表。

Minimum string length: 1
include_credits_usage
boolean

设为 true 时返回的会话带上 credits_usage_nano。不传或传 false 时跳过积分聚合,响应中不含该字段。

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

响应

成功

所有 Flashduty 公开 API 共用的标准响应结构。成功时 data 为接口专属载荷且不含 error;失败时 error 存在而 data 缺失。request_id 始终存在,并会同步写入 Flashcat-Request-Id 响应头。

request_id
string
必填

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

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

error
object

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

data
object

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