系统通知

获取系统通知(群变更、好友事件、封禁等);支持按类型过滤与分页。

契约预留

本平台为 reserved:以下签名来自已冻结绑定,示例为契约样例,不承诺可运行。

平台调用风格

异步风格:Promise<RcResult<T>>(不 reject;错误码在 RcResult.code);uint64/int64 映射为 number,超出安全整数时由实现改用 string。

接口一览​

操作语义传输返回
getSystemMessages系统通知历史(会话 conversationType=SYSTEM,targetId='system')。REST(客户端){messages:Message[], hasMore:bool}

本页 1 个操作,其中 1 个在本平台绑定中声明了方法签名。

跨端方法名​

操作AndroidWebElectronmacOSFlutterNative (C ABI)iOS
getSystemMessagesgetSystemMessagesgetSystemMessagesgetSystemMessagesgetSystemMessagesgetSystemMessages—func

方法名在 GA 平台之间保持一致(规则 A);Native C ABI 只覆盖部分操作,其余操作以 — 标注。

getSystemMessages​

系统通知历史(会话 conversationType=SYSTEM,targetId='system')。

getSystemMessages(options?: HistoryOptions): Promise<RcResult<HistoryPage>>
REST(客户端)since 1.0.0
参数
参数类型说明
options{limit?:uint32,beforeSeq?:uint64}可选;选项对象(字段见类型列):{ limit?:uint32, beforeSeq?:uint64 }
返回

{messages:Message[], hasMore:bool} 历史消息页与是否还有更早数据

示例
TypeScript
// HarmonyOS 绑定为契约预留,以下为声明样例
const res = await client.getSystemMessages({  });
if (res.code !== 0) { console.error(res.msg); }
错误码
错误码名称分类HTTP可重试说明
1001INVALID_PARAMETER客户端 / 参数 / 权限400否参数错误

相关文档​