Skip to main content
POST
导出 Issue 列表

限制说明

使用说明

  • 响应为 text/csv 流,通过 Content-Disposition: attachment 交付——不使用标准信封。文件名为 rum-issues-<时间戳>.csv,按请求的 time_zone 打时间戳。请通过 X-Export-TotalX-Export-Truncated 响应头获取总数与截断情况。
  • 导出读取前 100 条匹配记录(ExportMaxRows);匹配数超过上限时 X-Export-Truncatedtrueplimit 被忽略。
  • 请求过滤条件与 POST /rum/issue/list 完全一致——导出就是“我正在看的列表,输出成文件”。
  • export_fields 按顺序指定 CSV 列;未知键会被拒绝;空数组使用默认列集。
  • time_zone 必须是合法的 IANA 时区名(如 Asia/ShanghaiUTC);时间戳按该时区渲染,时间列表头携带时区。非法时区名会被拒绝。
  • console_origin 用于拼接 issue_url 列;服务无法自行推断(SaaS、私有化与 dev 环境地址不同)。
  • 每次调用都会记录到账户审计日志,包含调用者成员 ID、请求负载与最终错误(如有)。请勿在请求字段中放置敏感信息。

授权

app_key
string
query
必填

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

请求体

application/json

导出 RUM 异常追踪 Issue 的过滤参数。

start_time
integer<int64>
必填

时间范围起始,Unix 毫秒时间戳。

end_time
integer<int64>
必填

时间范围结束,毫秒时间戳,最大范围 183 天。

application_ids
string[]

按应用 ID 过滤;应用 ID 可通过 POST /rum/application/list 获取。

dql
string

DQL 高级过滤查询,不能与 sql 同时使用。

sql
string

SQL 式高级过滤查询,不能与 dql 同时使用。

statuses
enum<string>[]

按状态过滤,取值见枚举;传入其他值会报参数错误。

可用选项:
for_review,
reviewed,
ignored,
resolved
suspected_causes
enum<string>[]

按疑似原因过滤,取值见枚举。

可用选项:
api.failed_request,
network.error,
code.exception,
code.invalid_object_access,
code.invalid_argument,
unknown
team_ids
integer<int64>[]

按团队 ID 过滤;团队 ID 可通过 POST /team/list 获取。

p
integer

页码(从 1 开始)。导出时忽略——始终读取前 100 条匹配记录。

limit
integer

每页条数(1–100)。导出时忽略——行数上限固定为 100。

orderby
enum<string>

排序字段;缺省时按 updated_at 排序。

可用选项:
created_at,
updated_at,
session_count,
error_count,
severity
asc
boolean

true 时升序排列;默认降序。

error_required
boolean

true 时仅导出有关联错误事件的 Issue。

by_intersection
boolean

true 时按时间交集匹配:导出在时间窗口内仍有活动的 Issue(last_seen_timestamp 不早于 start_time),即使其创建于窗口之前;默认 false 仅导出创建于窗口内的 Issue。

export_fields
enum<string>[]

按顺序指定导出的 CSV 列;未知键会被拒绝;空数组使用默认列集。

可用选项:
issue_id,
issue_url,
application_name,
service,
error_type,
error_message,
status,
severity,
is_crash,
error_count,
session_count,
first_seen_at,
first_seen_version,
last_seen_at,
last_seen_version,
versions,
suspected_cause,
resolved_at
console_origin
string

用于拼接 issue_url 列的控制台地址,如 https://console.flashcat.cloud;服务无法自行推断(SaaS、私有化与 dev 环境地址不同)。

time_zone
string

渲染 CSV 时间戳所用的 IANA 时区名,如 Asia/ShanghaiUTC;默认 Asia/Shanghai

响应

Success. CSV attachment, not a JSON envelope.

CSV file content. The header row matches the exported columns in order; values are sanitized against spreadsheet formula injection.