docs-mastodon/content/zh-cn/entities/WebPushSubscription.md

title	description	menu	aliases
WebPushSubscription	表示一个对流式推送的订阅。	docs parent entities	/entities/pushsubscription /entities/PushSubscription /entities/webpushsubscription /entities/WebPushSubscription /api/entities/pushsubscription /api/entities/PushSubscription /api/entities/webpushsubscription /api/entities/WebPushSubscription

示例

{
  "id": 328183,
  "endpoint": "https://yourdomain.example/listener",
  "standard": true,
  "alerts": {
    "follow": false,
    "favourite": false,
    "reblog": false,
    "mention": true,
    "poll": false
  },
  "server_key": "BCk-QqERU0q-CfYZjcuB6lnyyOYfJ2AifKqfeGIm7Z-HiTU5T9eTG5GxVA0_OH5mMlI4UkkDTpaZwozy0TzdZ2M="
}

属性

id

描述: Web Push 订阅在数据库中的ID。
类型: 字符串 (从整数转换而来，但不保证一定为数字)
版本历史:
2.4.0 - 添加

endpoint

描述: 推送通知将发送到的地址。
类型: 字符串（URL）
版本历史:
2.4.0 - 添加

standard

描述: 推送消息是否遵循标准化规范 (RFC8030+RFC8291+RFC8292)。若为 false，则遵循该规范的旧版本（RFC8291 的第 4 版草案和 RFC8292 的第 1 版草案）。 类型: 布尔值
版本历史:
4.4.0 - 添加

server_key

描述: 流式推送实例的 VAPID 密钥。
类型: 字符串
版本历史:
2.4.0 - 添加

alerts

描述: 哪些提醒会被传递到 endpoint。
类型: 哈希
版本历史:
2.4.0 - 添加
2.8.0 - 添加 alerts[poll]
3.1.0 - 添加 alerts[follow_request]
3.3.0 - 添加 alerts[status]
3.5.0 - 添加 alerts[update] 和 alerts[admin.sign_up]
4.0.0 - 添加 alerts[admin.report]

alerts[mention]

描述: 当有人在嘟文中提及你时，是否接收推送通知？
类型: 布尔值
版本历史:
2.4.0 - 添加

alerts[status]

描述: 当启用了发嘟通知的帐户发布嘟文时，是否接收推送通知？
类型: 布尔值
版本历史:
3.3.0 - 添加

alerts[reblog]

描述: 当你创建的嘟文被其他人转发时，是否接收推送通知？
类型: 布尔值
版本历史:
2.4.0 - 添加

alerts[follow]

描述: 当有人关注你时，是否接收推送通知？
类型: 布尔值
版本历史:
2.4.0 - 添加

alerts[follow_request]

描述: 当有人请求关注你时，是否接收推送通知？
类型: 布尔值
版本历史:
3.1.0 - 添加

alerts[favourite]

描述: 当你创建的嘟文被其他人喜欢时，是否接收推送通知？
类型: 布尔值
版本历史:
2.4.0 - 添加

alerts[poll]

描述: 当你投票或创建的投票结束时，是否接收推送通知？
类型: 布尔值
版本历史:
2.8.0 - 添加

alerts[update]

描述: 当你互动过的嘟文被编辑时，是否接收推送通知？
类型: 布尔值
版本历史:
3.5.0 - 添加

alerts[admin.sign_up]

描述: 当有新用户注册时，是否接收推送通知？
类型: 布尔值
版本历史:
3.5.0 - 添加

alerts[admin.report]

描述: 当提交新的举报时，是否接收推送通知？
类型: 布尔值
版本历史:
4.0.0 - 添加

参见

{{< page-relref ref="methods/push" caption="push API 方法" >}}

{{< caption-link url="https://github.com/mastodon/mastodon/blob/main/app/serializers/rest/web_push_subscription_serializer.rb" caption="app/serializers/rest/web_push_subscription_serializer.rb" >}}

{{< translation-status-zh-cn raw_title="WebPushSubscription" raw_link="/entities/WebPushSubscription/" last_translation_time="2025-04-21" raw_commit="6addd5cf525adec1859f48c52dafcfe1f96e558a">}}