跳转到主要内容
POST
查询 Sourcemap 列表

限制说明

使用说明

  • start_time 和 end_time 为必填字段,均使用 Unix 时间戳(毫秒),按上传时间过滤,最大时间跨度 365 天。
  • type 选择平台符号文件库:browser、android、ios、miniprogram、react-native、harmony、flutter 或 electron。省略时默认为 browser;其他取值(包括 web)返回空结果。
  • kind: native 会把 android 和 harmony 切换到各自的 native .so 符号库。
  • 默认每页 20 条,最大 100 条,默认按 created_at 倒序排列。
  • build_id、uuid、query 均为子串匹配。uuid 以及 iOS 的 query 会先转为大写并去掉连字符再匹配。
  • 无匹配记录时 items 和 total 都不返回,data 为空对象。

授权

app_key
string
query
必填

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

请求体

application/json

Sourcemap 列表的分页过滤条件。

end_time
integer<int64>
必填

上传时间范围结束,Unix 毫秒时间戳。最大时间跨度 365 天。

start_time
integer<int64>
必填

上传时间范围起始,Unix 毫秒时间戳。需大于 0 且小于 end_time。

asc
boolean
默认值:false

升序排序。默认 false(降序)。

build_id
string

按构建 ID 子串过滤(Android Gradle 插件构建标识,或 native 符号的 build ID)。最多 200 个字符。

Maximum string length: 200
kind
enum<string>

符号类型过滤,仅 Android 与鸿蒙生效(其他平台忽略):mapping(默认)列出 ProGuard/R8 mapping 或 ArkTS Sourcemap,native 列出 native .so 符号。

可用选项:
mapping,
native
limit
integer
默认值:20

每页条数,最大 100,默认 20。

必填范围: x <= 100
示例:

20

orderby
enum<string>

排序字段;缺省时按 created_at 降序排序。

可用选项:
created_at,
updated_at
p
integer
默认值:1

页码,从 1 开始。

必填范围: x >= 1
示例:

1

query
string

自由文本子串匹配。JS 类存储(browser/react-native/harmony/miniprogram)匹配 minified_url,android/flutter/electron 及 kind=native 的 harmony 匹配 build_id,ios 匹配 uuid(不区分大小写,忽略连字符)。

Maximum string length: 200
services
string[]

按服务名称过滤,最多 100 个值。

Maximum array length: 100
type
enum<string>

要查询的符号文件平台。省略时默认为 browser;传入其他值会返回空列表。

可用选项:
browser,
android,
ios,
miniprogram,
react-native,
harmony,
flutter,
electron
uuid
string

仅 iOS。按 dSYM UUID 子串过滤,匹配前会转为大写并去掉连字符。最多 200 个字符。

Maximum string length: 200
versions
string[]

按版本字符串过滤,最多 100 个值。

Maximum array length: 100

响应

成功

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

request_id
string
必填

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

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

data
object

Sourcemap 记录的分页列表。