撤回通知消息
======

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

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/cf/v3/Mb9qzQKfSvCsl4UGdyPD7Q/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073639Z&HW-CC-Expire=86400&HW-CC-Sign=288C23B75C70F317E48F359564C4974213B79A75EC24AE9B98D99A2B5510C45F)

*   消息撤回仅支持使用token和notifyId撤回。
    
*   若要使用消息撤回功能，请确保您在推送消息时设置了notifyId字段。
    
*   消息撤回仅支持以下类型：
    
    还未下发到端侧的消息。
    
    已在终端展示但用户还未点击的消息。
    
*   消息撤回不会影响应用的通知角标。
    

#### 约束与限制

撤回通知消息能力支持Phone、Tablet、PC/2in1设备。并且从5.1.0(18)版本开始，新增支持Wearable设备；从5.1.1(19)版本开始，新增支持TV设备。

#### 开发步骤

1.  参考[开发步骤](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/push-send-alert#开发步骤)章节进行消息推送，确保应用可正常收到通知消息。
    
2.  应用服务端调用REST API撤回通知消息，消息详情可参见[消息撤回](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/push-msg-revoke)，请求示例如下：
    
    // 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: 0
     
    // Request Body
    {
      "notifyId": 1234567,
      "token": \[
        "pushToken1",
        "pushToken2",
        "pushToken3"
      \]
    }
    
    *   \[clientId\]：请替换为您应用的Client ID，可参见[指导](https://developer.huawei.com/consumer/cn/doc/app/agc-help-view-app-info-0000002282674569)获取。
    *   Authorization：JWT格式字符串，可参见[Authorization](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/push-msg-revoke#request-header)获取。
    *   push-type：0表示通知消息场景。
    *   notifyId：消息ID，消息的唯一标识，详情请参见[notifyId](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/push-msg-revoke#request-body)。
    *   token：Push Token，可参见[获取Push Token](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/push-get-token)获取。