curl --request POST \
--url 'https://api.flashcat.cloud/rum/issue/export?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"application_ids": [
"eWbr4xk3ZRnLabRa6unqwD"
],
"console_origin": "https://console.flashcat.cloud",
"end_time": 1775961914595,
"export_fields": [
"issue_id",
"error_type",
"error_message",
"status",
"error_count",
"session_count",
"last_seen_at"
],
"orderby": "updated_at",
"start_time": 1772611200000,
"statuses": [
"for_review"
],
"time_zone": "Asia/Shanghai"
}
'import requests
url = "https://api.flashcat.cloud/rum/issue/export?app_key="
payload = {
"application_ids": ["eWbr4xk3ZRnLabRa6unqwD"],
"console_origin": "https://console.flashcat.cloud",
"end_time": 1775961914595,
"export_fields": ["issue_id", "error_type", "error_message", "status", "error_count", "session_count", "last_seen_at"],
"orderby": "updated_at",
"start_time": 1772611200000,
"statuses": ["for_review"],
"time_zone": "Asia/Shanghai"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
application_ids: ['eWbr4xk3ZRnLabRa6unqwD'],
console_origin: 'https://console.flashcat.cloud',
end_time: 1775961914595,
export_fields: [
'issue_id',
'error_type',
'error_message',
'status',
'error_count',
'session_count',
'last_seen_at'
],
orderby: 'updated_at',
start_time: 1772611200000,
statuses: ['for_review'],
time_zone: 'Asia/Shanghai'
})
};
fetch('https://api.flashcat.cloud/rum/issue/export?app_key=', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.flashcat.cloud/rum/issue/export?app_key=",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'application_ids' => [
'eWbr4xk3ZRnLabRa6unqwD'
],
'console_origin' => 'https://console.flashcat.cloud',
'end_time' => 1775961914595,
'export_fields' => [
'issue_id',
'error_type',
'error_message',
'status',
'error_count',
'session_count',
'last_seen_at'
],
'orderby' => 'updated_at',
'start_time' => 1772611200000,
'statuses' => [
'for_review'
],
'time_zone' => 'Asia/Shanghai'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.flashcat.cloud/rum/issue/export?app_key="
payload := strings.NewReader("{\n \"application_ids\": [\n \"eWbr4xk3ZRnLabRa6unqwD\"\n ],\n \"console_origin\": \"https://console.flashcat.cloud\",\n \"end_time\": 1775961914595,\n \"export_fields\": [\n \"issue_id\",\n \"error_type\",\n \"error_message\",\n \"status\",\n \"error_count\",\n \"session_count\",\n \"last_seen_at\"\n ],\n \"orderby\": \"updated_at\",\n \"start_time\": 1772611200000,\n \"statuses\": [\n \"for_review\"\n ],\n \"time_zone\": \"Asia/Shanghai\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.flashcat.cloud/rum/issue/export?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"application_ids\": [\n \"eWbr4xk3ZRnLabRa6unqwD\"\n ],\n \"console_origin\": \"https://console.flashcat.cloud\",\n \"end_time\": 1775961914595,\n \"export_fields\": [\n \"issue_id\",\n \"error_type\",\n \"error_message\",\n \"status\",\n \"error_count\",\n \"session_count\",\n \"last_seen_at\"\n ],\n \"orderby\": \"updated_at\",\n \"start_time\": 1772611200000,\n \"statuses\": [\n \"for_review\"\n ],\n \"time_zone\": \"Asia/Shanghai\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/rum/issue/export?app_key=")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"application_ids\": [\n \"eWbr4xk3ZRnLabRa6unqwD\"\n ],\n \"console_origin\": \"https://console.flashcat.cloud\",\n \"end_time\": 1775961914595,\n \"export_fields\": [\n \"issue_id\",\n \"error_type\",\n \"error_message\",\n \"status\",\n \"error_count\",\n \"session_count\",\n \"last_seen_at\"\n ],\n \"orderby\": \"updated_at\",\n \"start_time\": 1772611200000,\n \"statuses\": [\n \"for_review\"\n ],\n \"time_zone\": \"Asia/Shanghai\"\n}"
response = http.request(request)
puts response.read_body"Issue ID,Error type,Error message,Status,Error count,Affected sessions,Last seen (Asia/Shanghai)\nNHEacQHi2DhXqobr9qPQz9,Error,Script error.,for_review,752,381,2026-04-12 10:43:59\nH8kZSmxiE7EgdyD4fCyyNa,Error,\"API ERROR: We encountered an internal error | POST /api/access/logout\",for_review,3,1,2026-04-03 12:41:24"{
"error": {
"code": "InvalidParameter",
"message": "The specified parameter is not valid."
},
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4"
}{
"error": {
"code": "Unauthorized",
"message": "You are unauthorized."
},
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4"
}{
"error": {
"code": "RequestTooFrequently",
"message": "Request too frequently."
},
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4"
}{
"error": {
"code": "InternalError",
"message": "We encountered an internal error, and it has been reported. Please try again later."
},
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4"
}导出 Issue 列表
将符合过滤条件的 RUM 异常追踪 Issue 导出为 CSV 文件。响应为 text/csv 流,通过 Content-Disposition: attachment 交付——不是 JSON 信封;非控制台调用方可通过 X-Export-Total 与 X-Export-Truncated 响应头获知匹配总数与截断情况。
curl --request POST \
--url 'https://api.flashcat.cloud/rum/issue/export?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"application_ids": [
"eWbr4xk3ZRnLabRa6unqwD"
],
"console_origin": "https://console.flashcat.cloud",
"end_time": 1775961914595,
"export_fields": [
"issue_id",
"error_type",
"error_message",
"status",
"error_count",
"session_count",
"last_seen_at"
],
"orderby": "updated_at",
"start_time": 1772611200000,
"statuses": [
"for_review"
],
"time_zone": "Asia/Shanghai"
}
'import requests
url = "https://api.flashcat.cloud/rum/issue/export?app_key="
payload = {
"application_ids": ["eWbr4xk3ZRnLabRa6unqwD"],
"console_origin": "https://console.flashcat.cloud",
"end_time": 1775961914595,
"export_fields": ["issue_id", "error_type", "error_message", "status", "error_count", "session_count", "last_seen_at"],
"orderby": "updated_at",
"start_time": 1772611200000,
"statuses": ["for_review"],
"time_zone": "Asia/Shanghai"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
application_ids: ['eWbr4xk3ZRnLabRa6unqwD'],
console_origin: 'https://console.flashcat.cloud',
end_time: 1775961914595,
export_fields: [
'issue_id',
'error_type',
'error_message',
'status',
'error_count',
'session_count',
'last_seen_at'
],
orderby: 'updated_at',
start_time: 1772611200000,
statuses: ['for_review'],
time_zone: 'Asia/Shanghai'
})
};
fetch('https://api.flashcat.cloud/rum/issue/export?app_key=', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.flashcat.cloud/rum/issue/export?app_key=",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'application_ids' => [
'eWbr4xk3ZRnLabRa6unqwD'
],
'console_origin' => 'https://console.flashcat.cloud',
'end_time' => 1775961914595,
'export_fields' => [
'issue_id',
'error_type',
'error_message',
'status',
'error_count',
'session_count',
'last_seen_at'
],
'orderby' => 'updated_at',
'start_time' => 1772611200000,
'statuses' => [
'for_review'
],
'time_zone' => 'Asia/Shanghai'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.flashcat.cloud/rum/issue/export?app_key="
payload := strings.NewReader("{\n \"application_ids\": [\n \"eWbr4xk3ZRnLabRa6unqwD\"\n ],\n \"console_origin\": \"https://console.flashcat.cloud\",\n \"end_time\": 1775961914595,\n \"export_fields\": [\n \"issue_id\",\n \"error_type\",\n \"error_message\",\n \"status\",\n \"error_count\",\n \"session_count\",\n \"last_seen_at\"\n ],\n \"orderby\": \"updated_at\",\n \"start_time\": 1772611200000,\n \"statuses\": [\n \"for_review\"\n ],\n \"time_zone\": \"Asia/Shanghai\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.flashcat.cloud/rum/issue/export?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"application_ids\": [\n \"eWbr4xk3ZRnLabRa6unqwD\"\n ],\n \"console_origin\": \"https://console.flashcat.cloud\",\n \"end_time\": 1775961914595,\n \"export_fields\": [\n \"issue_id\",\n \"error_type\",\n \"error_message\",\n \"status\",\n \"error_count\",\n \"session_count\",\n \"last_seen_at\"\n ],\n \"orderby\": \"updated_at\",\n \"start_time\": 1772611200000,\n \"statuses\": [\n \"for_review\"\n ],\n \"time_zone\": \"Asia/Shanghai\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/rum/issue/export?app_key=")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"application_ids\": [\n \"eWbr4xk3ZRnLabRa6unqwD\"\n ],\n \"console_origin\": \"https://console.flashcat.cloud\",\n \"end_time\": 1775961914595,\n \"export_fields\": [\n \"issue_id\",\n \"error_type\",\n \"error_message\",\n \"status\",\n \"error_count\",\n \"session_count\",\n \"last_seen_at\"\n ],\n \"orderby\": \"updated_at\",\n \"start_time\": 1772611200000,\n \"statuses\": [\n \"for_review\"\n ],\n \"time_zone\": \"Asia/Shanghai\"\n}"
response = http.request(request)
puts response.read_body"Issue ID,Error type,Error message,Status,Error count,Affected sessions,Last seen (Asia/Shanghai)\nNHEacQHi2DhXqobr9qPQz9,Error,Script error.,for_review,752,381,2026-04-12 10:43:59\nH8kZSmxiE7EgdyD4fCyyNa,Error,\"API ERROR: We encountered an internal error | POST /api/access/logout\",for_review,3,1,2026-04-03 12:41:24"{
"error": {
"code": "InvalidParameter",
"message": "The specified parameter is not valid."
},
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4"
}{
"error": {
"code": "Unauthorized",
"message": "You are unauthorized."
},
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4"
}{
"error": {
"code": "RequestTooFrequently",
"message": "Request too frequently."
},
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4"
}{
"error": {
"code": "InternalError",
"message": "We encountered an internal error, and it has been reported. Please try again later."
},
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4"
}限制说明
| 项目 | 说明 |
|---|---|
| 速率限制 | 每个账户 200 次/天;100 次/分钟;10 次/秒 |
| 权限要求 | 无 —— 持有有效的 app_key 即可调用 |
使用说明
- 响应为
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 毫秒时间戳。需大于 start_time,最大跨度 183 天。
时间范围起始,Unix 毫秒时间戳。
按应用 ID 过滤;应用 ID 可通过 POST /rum/application/list 获取。
为 true 时升序排列;默认降序。
为 true 时按时间交集匹配:导出在时间窗口内仍有活动的 Issue(last_seen_timestamp 不早于 start_time),即使其创建于窗口之前;默认 false 仅导出创建于窗口内的 Issue。
用于拼接 issue_url 列的控制台地址,如 https://console.flashcat.cloud;服务无法自行推断(SaaS、私有化与 dev 环境地址不同)。
DQL 高级过滤查询,不能与 sql 同时使用。
为 true 时仅导出有关联错误事件的 Issue。
要导出的 CSV 列,按出现顺序排列。未知键会被参数校验拒绝;传空数组则使用默认列集。
| 值 | 列内容 |
|---|---|
issue_id | Issue ID |
issue_url | Issue 详情页的控制台链接(基于 console_origin 拼接) |
application_name | 所属应用名称 |
service | 服务名 |
error_type | 错误类型 |
error_message | 错误信息 |
status | 处理状态 |
severity | 严重性 |
is_crash | 是否导致崩溃 |
error_count | 错误发生次数 |
session_count | 受影响会话数 |
first_seen_at | 首次出现时间(按 time_zone 渲染) |
first_seen_version | 首次出现时的应用版本 |
last_seen_at | 最近出现时间(按 time_zone 渲染) |
last_seen_version | 最近出现时的应用版本 |
versions | 涉及的所有版本 |
suspected_cause | 疑似根因分类 |
resolved_at | 解决时间(按 time_zone 渲染) |
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 每页条数(1–100)。导出时忽略——行数上限固定为 100。
1 <= x <= 100排序字段;缺省按 updated_at 排序。
| 值 | 含义 |
|---|---|
created_at | Issue 创建时间 |
updated_at | 最近更新时间 |
session_count | 受影响会话数 |
error_count | 错误发生次数 |
severity | 严重性等级(Critical > Warning > Info) |
created_at, updated_at, session_count, error_count, severity 页码(从 1 开始)。导出时忽略——始终读取前 100 条匹配记录。
x >= 1SQL 式高级过滤查询,不能与 dql 同时使用。
按处理状态过滤;传入其他值会被参数校验拒绝。
| 值 | 含义 |
|---|---|
for_review | 待处理 |
reviewed | 已查看 |
ignored | 已忽略 |
resolved | 已解决 |
for_review, reviewed, ignored, resolved 按疑似根因分类过滤。
| 值 | 含义 |
|---|---|
api.failed_request | API/接口请求失败(如 HTTP 4xx/5xx 响应) |
network.error | 网络连接错误(断网、请求中断等) |
code.exception | 代码异常(Syntax/Reference/Range 等运行时异常) |
code.invalid_object_access | 非法对象访问(如对 undefined/null 读取属性) |
code.invalid_argument | 非法参数(向函数传入了无效参数) |
unknown | 无法判定的未知原因 |
api.failed_request, network.error, code.exception, code.invalid_object_access, code.invalid_argument, unknown 按团队 ID 过滤;团队 ID 可通过 POST /team/list 获取。
渲染 CSV 时间戳所用的 IANA 时区名,如 Asia/Shanghai、UTC;默认 Asia/Shanghai。
响应
成功。CSV 附件,非 JSON 信封。
CSV file content. The header row matches the exported columns in order; values are sanitized against spreadsheet formula injection.
此页面对您有帮助吗?