导出 Issue 列表
将符合过滤条件的 RUM 异常追踪 Issue 导出为 CSV 文件。响应为 text/csv 流,通过 Content-Disposition: attachment 交付——不是 JSON 信封;非控制台调用方可通过 X-Export-Total 与 X-Export-Truncated 响应头获知匹配总数与截断情况。
限制说明
使用说明
- 响应为
text/csv流,通过Content-Disposition: attachment交付——不使用标准信封。文件名为rum-issues-<时间戳>.csv,按请求的time_zone打时间戳。请通过X-Export-Total与X-Export-Truncated响应头获取总数与截断情况。 - 导出读取前 100 条匹配记录(
ExportMaxRows);匹配数超过上限时X-Export-Truncated为true。p和limit被忽略。 - 请求过滤条件与
POST /rum/issue/list完全一致——导出就是“我正在看的列表,输出成文件”。 export_fields按顺序指定 CSV 列;未知键会被拒绝;空数组使用默认列集。time_zone必须是合法的 IANA 时区名(如Asia/Shanghai、UTC);时间戳按该时区渲染,时间列表头携带时区。非法时区名会被拒绝。console_origin用于拼接issue_url列;服务无法自行推断(SaaS、私有化与 dev 环境地址不同)。- 每次调用都会记录到账户审计日志,包含调用者成员 ID、请求负载与最终错误(如有)。请勿在请求字段中放置敏感信息。
授权
在 Flashduty 控制台 账户 → APP Key 中签发的 app_key。调用任何公开 API 时都必须携带。它等同于所属账户的身份凭证,请妥善保管。
请求体
导出 RUM 异常追踪 Issue 的过滤参数。
时间范围起始,Unix 毫秒时间戳。
时间范围结束,毫秒时间戳,最大范围 183 天。
按应用 ID 过滤;应用 ID 可通过 POST /rum/application/list 获取。
DQL 高级过滤查询,不能与 sql 同时使用。
SQL 式高级过滤查询,不能与 dql 同时使用。
按状态过滤,取值见枚举;传入其他值会报参数错误。
for_review, reviewed, ignored, resolved 按疑似原因过滤,取值见枚举。
api.failed_request, network.error, code.exception, code.invalid_object_access, code.invalid_argument, unknown 按团队 ID 过滤;团队 ID 可通过 POST /team/list 获取。
页码(从 1 开始)。导出时忽略——始终读取前 100 条匹配记录。
每页条数(1–100)。导出时忽略——行数上限固定为 100。
排序字段;缺省时按 updated_at 排序。
created_at, updated_at, session_count, error_count, severity 为 true 时升序排列;默认降序。
为 true 时仅导出有关联错误事件的 Issue。
为 true 时按时间交集匹配:导出在时间窗口内仍有活动的 Issue(last_seen_timestamp 不早于 start_time),即使其创建于窗口之前;默认 false 仅导出创建于窗口内的 Issue。
按顺序指定导出的 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 用于拼接 issue_url 列的控制台地址,如 https://console.flashcat.cloud;服务无法自行推断(SaaS、私有化与 dev 环境地址不同)。
渲染 CSV 时间戳所用的 IANA 时区名,如 Asia/Shanghai、UTC;默认 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.