消息附加功能

消息附加功能

附加信息（Extras）用于承载额外数据或改变客户端行为等。这些信息以键值对形式存储，且仅在接受‘application/json‘内容类型的‘POST /message‘请求中有效。

命名空间

.extras 下的键应采用以下格式：<顶级命名空间>:：[<子命名空间>:：]<操作>。部分命名空间被官方客户端所使用：

client::display

contentType

注意：Markdown 支持通过！ 渲染图片，这些图片在消息被查看时会自动下载。类似于电子邮件客户端默认阻止远程内容的原因，自动下载远程图片可能被用来收集用户信息。
此外，如果消息部分内容来自恶意外部源的插值，攻击者可能注入格式错误的 Markdown，从而导致信息泄露。
建议使用纯文本格式（text/plain）来减少使用外部来源（如脚本输出）文本时可能引发的安全问题。

示例

{
  "extras": {
    "client::display": {
      "contentType": "text/plain"
    }
  }
}

支持

client::notification

click.url

Click.url（字符串）：点击通知时打开一个 URL。

示例

{
  "extras": {
    "client::notification": {
      "click": {"url": "https://gotify.net"}
    }
  }
}

支持

bigImageUrl

大图网址（字符串）：在通知中显示大图。

示例

{
  "extras": {
    "client::notification": {
      "bigImageUrl": "https://placekitten.com/400/300"
    }
  }
}

支持

android::action

onReceive.intentUrl

OnReceive.intentUrl（字符串）：通知送达后打开一个意图。

示例

{
  "extras": {
    "android::action": {
      "onReceive": {"intentUrl": "https://gotify.net"}
    }
  }
}

支持