分发文档
变更撤回消息接口的公告 更新时间：2026-10-22 16:42:00
尊敬的开发者：
您好！
感谢您长期以来对小米推送服务的关注和大力支持。 为了向您提供更好的服务和体验，小米推送近期对“消息撤回”服务进行了调整，如您的应用正在使用消息撤回服务，请您务必于2026年11月30日23时59分前更新使用以下API地址，以免影响您正常使用推送服务。具体如下：
1. 新增V3消息撤回接口
| 撤回方式 | API地址 |
| 根据设备regId撤回消息 | https://api.xmpush.xiaomi.com/v3/message/regid/revoke |
| 根据设备alias撤回消息 | https://api.xmpush.xiaomi.com/v3/message/alias/revoke |
| 根据设备userAccount撤回消息 | https://api.xmpush.xiaomi.com/v3/message/user_account/revoke |
详细接入方法您可参考《服务器API地址以及参数》十三、消息撤回 一节。
2. 我们将于2026年12月1日0时起下线原V1和V2消息撤回接口，具体如下：
| 撤回方式 | API地址 |
| 根据设备regId撤回消息 | https://api.xmpush.xiaomi.com/v1/message/regid/revoke |
| 根据设备alias撤回消息 | https://api.xmpush.xiaomi.com/v1/message/alias/revoke |
| 根据设备userAccount撤回消息 | https://api.xmpush.xiaomi.com/v1/message/user_account/revoke |
| 根据消息id和jobkey撤回消息 | https://api.xmpush.xiaomi.com/v2/message/revoke |
| 撤回topic消息 | https://api.xmpush.xiaomi.com/v1/message/topic/revoke |
| 撤回多topic消息 | https://api.xmpush.xiaomi.com/v1/message/multi_topic/revoke |
如您的应用有使用消息撤回功能，请务必在2026年11月30日23点59分前切至V3消息撤回接口，以免影响您使用推送服务。您在切换过程如需其他帮助，可通过小米推送客服系统与我们联系：http://dev.xiaomi.com/mipush/feedback/fe/
感谢您的配合！
小米推送团队
2026年10月22日
上一篇:公告
下一篇:关于订阅消息及消息分类新规的通知
文档内容是否有帮助？
有帮助
无帮助