查询通知与通知配置

查看当前用户的通知和未读数量，并查询通知渠道及规则配置。本页不包含标记已读、删除通知、修改配置或发送测试通知。

前提条件

准备个人访问令牌。有关认证和查询范围，请参阅使用与监测。

调用顺序

  1. 查询通知列表，按时间范围、分类或已读状态定位需要查看的通知；需要完整结果时继续读取后续分页。

  2. 需要展示未读汇总时，独立查询未读通知数，查看总数及分类统计。

  3. 需要了解通知投递配置时，查询通知规则和渠道，将规则中的投递渠道与渠道列表对应，检查开关、优先级和只读状态。

API 操作

查看通知

要完成的事

API 操作

何时使用或确认什么

浏览通知记录

查询通知列表

查看通知内容及已读状态。

查看未读汇总

查询未读通知数

获取未读总数及分类统计。

查看投递配置

要完成的事

API 操作

何时使用或确认什么

查看接收渠道

查询通知渠道

检查站内、邮件和 Webhook 渠道配置。

查看触发规则

查询通知规则

检查规则开关、优先级、阈值和投递渠道。

结果确认

通过查询通知列表确认目标通知及其已读状态。检查配置时，对照规则的投递渠道和查询通知渠道的结果；配置存在并不证明某次通知已成功送达。

限制和注意事项

  • 通知列表默认只查询最近七天，不能将一页通知数量直接当作未读总数。

  • 查询返回的渠道或阈值可能标记为只读，不应从查询结果推断它们可修改。

  • 这些操作只读取通知和配置，不会标记已读或触发通知投递。

最后更新于