Skip to main content
POST
查询会话回放分段

限制说明

使用说明

  • url_modefalse(默认)时,响应以 application/x-ndjson 流式返回——每行是一条解压后的回放分段 JSON 记录——且不会包裹在标准信封中;下一页的分页游标改由响应头 X-Search-After-Ctx 返回,而非响应体字段。
  • url_modetrue 时,响应为标准 JSON 信封,内含分段的预签名下载地址(1 小时内有效),而非原始字节流。
  • 传入 ts 可从该时间点之前最近的一个全量快照分段开始定位,而非从会话起始处分页。
  • limit 取值范围 1-99;传入 100 及以上将被拒绝。

授权

app_key
string
query
必填

在 Flashduty 控制台 账户 → APP Key 中签发的 app_key。调用任何公开 API 时都必须携带。它等同于所属账户的身份凭证,请妥善保管。

请求体

application/json

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

session_id
string
必填

RUM 会话 ID。

view_id
string

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

search_after_ctx
string

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

ts
integer<int64>

Unix 毫秒时间戳。设置该字段且 search_after_ctx 为空时,将从该时间点之前最近的一个全量快照分段开始,而非从头开始。

url_mode
boolean

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

limit
integer
默认值:20

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

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

响应

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

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

request_id
string
必填

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

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

data
object
必填

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