跳转到主要内容
POST
创建应用

限制说明

使用说明

  • type 须为以下之一:browser、ios、android、react-native、flutter、kotlin-multiplatform、roku、unity、miniprogram、harmony、electron。
  • client_token 由服务端生成,用于初始化 RUM SDK;之后也可通过 POST /rum/application/info 再次获取。
  • 传入 tracing 时,即使 enabled 为 false,也必须提供 open_type(popup 或 tab)和以 http/https 开头的 endpoint。
  • links.systems[].url 必须以 http 或 https 开头;每个系统都需要 name 和至少一个 event_types。
  • alerting.delivery_mode 为 oncall(Flashduty 云端默认值)时,服务端会创建或复用账户的 RUM 告警集成,并在 alerting.integration_id 中返回其 ID。
  • 服务端不校验 team_id 是否为调用者所在的团队。
  • 每次调用都会记录到账户审计日志,请不要把敏感信息放在请求字段中。

授权

app_key
string
query
必填

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

请求体

application/json

创建 RUM 应用的参数。

application_name
string
必填

应用名称,1–40 个字符。

Required string length: 1 - 40
team_id
integer<int64>
必填

所属团队 ID,可通过 POST /team/list 获取。

必填范围: x > 1
type
enum<string>
必填

平台标识:

可用选项:
browser,
ios,
android,
react-native,
flutter,
kotlin-multiplatform,
roku,
unity,
miniprogram,
harmony,
electron
alerting
object

告警配置;不传则默认不启用(enabled 为 false)。

is_private
boolean

为 true 时,仅账户所有者、账户管理员、创建者和所属团队成员可以查看或编辑该应用。默认 false。

外部链接集成配置,可选。

repositories
object[]

要关联的代码仓库,有序;第一个为主仓库。最多 10 个。

Maximum array length: 10
no_geo
boolean

为 true 时不根据客户端 IP 推断地理位置。默认 false。

no_ip
boolean

为 true 时不采集客户端 IP 地址。默认 false。

tracing
object

可选的 APM 链路集成配置。不传时保存为空配置(enabled: false,open_type 和 endpoint 为空)。

响应

成功

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

request_id
string
必填

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

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

data
object

创建 RUM 应用的结果。