华为HarmonyOS灵活高效的消息推送服务(Push Kit) -- 9 撤回通知扩展消息

场景介绍

当推送的通知扩展消息内容有误或者存在违规情况时，可能会引起用户投诉或监管部门处罚等不良后果。Push Kit为您提供消息撤回功能，降低此类推送可能造成的影响。

说明

• 消息撤回当前仅支持使用Token和notifyId撤回。
• 若要使用消息撤回功能，请确保您在推送通知扩展消息时设置了notifyId字段。
• 消息撤回仅支持以下类型：还未下发到端侧的消息，已在终端展示但用户还未点击的消息。

开发步骤

1. 参考发送通知扩展消息章节进行消息推送，确保应用可正常收到通知扩展消息。

2. 应用服务端调用REST API撤回通知消息，消息详情可参见消息撤回，请求示例如下：

   ​
   // Request URL
   POST https://push-api.cloud.huawei.com/v1/[clientid]/messages:revoke
   // Request Header
   Content-Type:application/json
   Authorization:Bearer eyJr*****OiIx---****.eyJh*****iJodHR--***.QRod*****4Gp---****
   push-type: 2
   // Request Body
   {
   "notifyId": 1234567,
   "token": [
   "pushToken1",
   "pushToken2",
   "pushToken3"
   ]
   }
   ​

   • clientid：请替换为您应用的Client ID，可参见指导获取。
   • Authorization：JWT格式字符串，可参见Authorization获取。
   • push-type：2表示通知扩展消息场景。
   • notifyId：消息ID，消息的唯一标识，详情请参见notifyId。
   • token：Push Token，可参见获取Push Token获取。