跳转到主要内容
POST
查询会话回放分段

限制说明

使用说明

  • 当 url_mode 为 false(默认)时,响应以 application/x-ndjson 流式返回——每行是一条解压后的回放分段 JSON 记录——且不会包裹在标准信封中;下一页的分页游标改由响应头 X-Search-After-Ctx 返回,而非响应体字段。读取失败的分段会被直接跳过。
  • 当 url_mode 为 true 时,响应为标准 JSON 信封,内含分段对象(zlib 压缩)的预签名下载地址,1 小时内有效。
  • 传入 ts(且不传 search_after_ctx)时,从该时间点及之前最近的全量快照分段开始,最多向前查找 4 小时;找不到时从头开始分页。
  • 只要本页取满 limit 个分段就会返回游标,因此最后一页可能为空。
  • limit 取值范围 1-99;传入 100 及以上将被拒绝。
  • 会话所属的私有应用调用者无权访问时,返回 AccessDenied(“You do not have permission to access this application”)。
  • 本页没有分段时返回空结果。刚上传的分段可能尚未完成索引,此时返回 ResourceNotFound(“Replay segments are not available yet. Please retry shortly”),稍后重试即可。

授权

app_key
string
query
必填

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

请求体

application/json

分页获取会话(或会话内单个视图)录制的回放分段。

session_id
string
必填

RUM 会话 ID(RUM 事件中的 session.id)。

limit
integer
默认值:20

返回的分段数量上限。取值 1-99,默认 20。

必填范围: 1 <= x <= 99
search_after_ctx
string

上一次调用返回的分页游标。取自 search_after_ctx 字段(URL 模式)或响应头 X-Search-After-Ctx(流式模式)。

ts
integer<int64>

Unix 毫秒时间戳。传入且 search_after_ctx 为空时,从该时间点及之前最近的全量快照分段开始分页(最多向前查找 4 小时);找不到时从头开始。

url_mode
boolean

为 true 时,以 JSON 信封形式返回预签名下载地址,而非流式返回分段字节。默认为 false。

view_id
string

仅返回属于该视图的分段。留空则在整个会话范围内分页。

响应

成功。响应体形状取决于 url_mode——详见使用说明。

成功响应结构。2xx 响应中 request_id 标识本次调用(同时出现在 Flashcat-Request-Id 响应头中),data 为接口业务 payload。失败响应使用不同结构,参见 ErrorResponse。

request_id
string
必填

本次请求的唯一 ID,也会在 Flashcat-Request-Id 响应头中返回。反馈问题时请一并附上。

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

data
object

分段的预签名下载地址,仅当 url_mode 为 true 时返回。