场景介绍
当推送的通知扩展消息内容有误或者存在违规情况时,可能会引起用户投诉或监管部门处罚等不良后果。Push Kit为您提供消息撤回功能,降低此类推送可能造成的影响。
说明
- 消息撤回当前仅支持使用Token和notifyId撤回。
- 若要使用消息撤回功能,请确保您在推送通知扩展消息时设置了notifyId字段。
- 消息撤回仅支持以下类型:还未下发到端侧的消息,已在终端展示但用户还未点击的消息。
开发步骤
- 参考发送通知扩展消息章节进行消息推送,确保应用可正常收到通知扩展消息。
- 应用服务端调用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获取。