为了改善小米终端用户的通知体验，营造良好可持续的推送生态，小米推送对推送消息数量、推送速率QPS进行了统一管理。

一、每日推送数量限制

根据《小米推送消息分类新规》，小米推送将消息分为“私信消息”和“公信消息”两个类别，若应用选择不接入私信或公信，则会接入默认通道。

2023年2月1日起按照本新规中的消息分类正式运行。

1、限制规则

私信消息的单日推送数量不受限，公信消息的单日推送数量进行上限管理，具体如下：

公信消息单日可推送总量的计算公式：应用在小米澎湃OS（Xiaomi HyperOS）、MIUI上安装且通知开启数x倍数。默认倍数为2倍，具备《互联网新闻信息服务许可证》的应用为3倍，具体如表1所示。通知开启数小于10000的按10000计数。

表1 公信消息限制倍数

说明：

• “应用在小米澎湃OS（Xiaomi HyperOS）、MIUI上安装且通知开启”的定义：用户已激活应用且应用通知权限为“开启”状态。
• 单日推送限额数以“送达量”计算，当日送达量超限则会计入管控。

2、消息量申诉

若特殊情况需要额外提升推送量级，开发者可以向小米推送进行申诉。

申诉条件：

开发者因业务需要确实需要发送额外量级的消息，并且用户确实希望收到该应用的推送消息。

申诉方法：

联系邮箱：mipush-permission@xiaomi.com。

3、FAQ

3.1、如果推送数量超过当日限制时，会有什么提示吗？

推送数量超过当日限制时，会调用请求失败，返回错误码200001，原因：exceed quota, quota: 当日可以下发总数, have acked: 当日已送达数。

如果您接了消息回执callback，推送总量超限时callback会返回如下json（需要先订阅callback.type为128，参见“消息回执”）：

{
data={
"axo00546585203029498oV": {"extra":{"ack":"当日已送达数","quota":"当日可以下发总数"},"type":128,"targets":"alias","timestamp":1585203103625}
  }
}

说明：

如果调用我们的multi接口（例如/v2/multi_messages/regids）发送消息，在推送数量超过当日限制时，不会返回错误码200001，而是通过channel_exceed_quota字段返回本次请求中各个通道的超额消息数，例如：

{"result":"ok","trace_id":"******************","code":0,"data":{"day_acked":"50078","id":"******************","channel_exceed_quota":"no_channel:2 a:3 ","day_quota":"50000"},"description":"成功"]

上面的返回结果表明，本次请求由于推送数量超限，会有2条没有带channel_id的消息以及3条channel_id为a的消息不会下发，其余消息则会正常下发。

3.2、如何查询每日剩余可推送数量？

在调用推送请求的响应中会返回当日可下发总量和当日已送达数。

示例：

{"result":"ok","trace_id":"Xxo00563585646156570hY","code":0,"data":{"data":{"day_acked":1,"day_quota":250}},"description":"成功"}

• day_acked表示当日已送达数
• day_quota表示当日可下发总量

如果您希望通过独立接口查询，可调用如下API（1秒限调用1次）：

https://api.xmpush.xiaomi.com/v1/trace/quota/get

HTTP请求方法：GET

添加HEADER字段Authorization，用于身份验证。格式是 key=<APP_SECRET>。

APP_SECRET是从开发者网站申请得到。

注意：字符key必须小写，例如：Authorization: key=YOUR_APP_SECRET

3.3、如果推送数量不够用，怎么办？

建议开发者优化推送策略，做精细化推送，尽量减少或避免全量用户的推送。

如果开发者应用的消息内容中有符合私信消息的内容，建议开发者申请和接入私信消息Channel，申请方式请参见《小米推送消息分类新规》，接入后该类消息将不受限制。

如果开发者确实有增加消息量的需要，比如有大量用户因收不到消息而投诉，开发者可以向小米推送申请增加消息量级，申请方式请参见“消息量申诉”。

二、临时推送数量限制

为了给用户与开发者提供更加优质的服务与体验，小米推送基于 “动态关闭率” 对推送消息数量进行统一管理。此规则旨在通过精细化管理，协助开发者提升推送效果，实现推送服务的精准触达与高效运营。

1、限制规则

当应用单月日均动态关闭率＞0.05%时，小米推送将以邮件的方式提示开发者进行整改；若30天整改期内，日均动态关闭率仍＞0.05%（即未完成整改），小米推送将按表2所示规则限制消息推送额度；若应用当月被限制额度，次月日均动态关闭率≤ 0.05%，则次月恢复该应用原有推送额度。

表2 公信消息受动态关闭率限制倍数

注意：

• 月日均动态关闭率＞0.05%，指应用当月平均每日的通知权限关闭率＞0.05%。若日均关闭率＞0.05%，则当月整体通知权限关闭率＞1.5%。若长期未启动优化整改，应用年度可触达用户规模预计下降幅度18%。
• 具备《互联网新闻信息服务许可证》的应用，若当月日均动态关闭率＞0.05%时，单个应用单日通知推送数量限制倍数为2.5倍，单个设备单日单应用接收通知数量为5条。
• 开发者收到整改提示邮件后，需在30天内完成整改并反馈整改结果，否则无法恢复原有推送额度。

2、说明

• 动态关闭率=新增通知关闭数/通知开启数，月日均动态关闭率以当月每日均值计算；
• 新增通知关闭数：统计周期内，终端用户将应用的通知权限由“开启”调整为“关闭”的设备数；
• 通知开启数：统计周期内，终端用户已激活应用且应用通知权限为“开启”的设备总数；
• 动态关闭率查询方式：小米推送运营平台-推送统计-用户数据-动态关闭率。

3、消息量申诉

• 若开发者对限制推送额度有异议，需在收到调整邮件后的3个工作日内，通过邮箱mipush-permission@xiaomi.com提交申诉，同一事件仅允许申诉1次。
• 申诉需提供包含整改规划及整改期限的整改方案，小米推送将从真实性、合理性及影响范围等维度进行评议并反馈结果。若评议通过，可维持原有推送额度；若未通过，则按规则执行。
• 逾期未申诉、未按时申诉或申诉未通过的，将按规则执行限制推送额度。
• 如有疑问，可通过小米推送客服系统咨询。

申诉流程：

4、FAQ

4.1、如何将动态关闭率控制在0.05%以内?

建议开发者减少低质内容及营销广告推送，优化策略做个性化、精细化推送，避免全量推送与频繁打扰，同时每日监控关闭率数据，接近0.05%阈值时及时调整策略，以有价值的消息提升用户留存，而非依赖高频推送。

三、推送速率QPS限制

1、限制规则

小米推送对推送速率（QPS）的分配主要依据应用的通知权限开启数进行分级计算。

QPS：表示1秒可调用的请求数。1个请求里最多可以携带1000个目标设备。例如：3000QPS时，1秒内最多可推送300万设备。

不同量级的通知开启数分配不同的QPS：

2、FAQ

2.1 QPS超限时会返回什么错误吗？

QPS超限时会返回错误码200002， 原因：send message too frequent!

需降低并发请求数，确保每秒的请求数不高于QPS限制，否则将无法推送。

优化建议：

可以考虑多用聚合消息，降低QPS。

如使用https://api.xmpush.xiaomi.com/v2/message/regid 或者 https://api.xmpush.xiaomi.com/v3/message/regid 将单条消息发送给多个目标用户。

四、音视频通话功能限制

1、限制规则

为规范音视频通话功能的使用，保障用户通信安全与服务质量，小米推送对音视频通话功能实施统一管理。符合特定申请条件的应用，可通过下述流程提交使用申请，审核通过后即可合规调用该功能。

2、申请流程

请提供如下信息至mipush-permission@xiaomi.com进行申请，我们会在15个工作日内回复申请结果，请您留意邮箱消息。

邮件主题：【Voip Service Kit 功能申请】 - 应用名称 - 申请日期

邮件正文：需包含申请功能名称、企业名称、应用名称、应用包名、 AppID 、channel信息、使用场景 、消息展示截图（展示需要特殊权限的通知消息截图，如音视频通话界面、音视频通话开关设置项等）

申请模板（示例）：

邮件主题：【Voip Service Kit 功能申请】 - Mi LINK（应用名称） - 20251014（申请日期）
邮件正文：
申请权限名称：Voip Service Kit 功能
企业名称：****
应用名称： Mi LINK
应用包名：****
AppID：****
channel_id：101112
channel名称：****
channel描述：非必填
消息分类：即时消息
使用场景： Mi LINK是**企业内部沟通软件，提供音视频通话服务，希望借助Voip Service Kit实现音视频通话功能。
应用下载二维码及测试登录帐号：
音视频通话开关设置项截图、音视频通话界面截图：（请提供用户在App内可设置是否接收消息提醒的开关界面截图，界面内需有明确文字提示用户开启后将会接收到通知栏消息）
承诺信息：
1. （应用名称）的（功能名称）仅用于符合规定的场景中（具体场景）。
2. 用户未触发或未使用语音通话相关功能时不会调用Voip Service Kit服务。
3. 如有违反上述1、2的其他行为，同意小米推送回收前述功能的使用权限且不再接受该应用其他推送服务的申请。

注意：

• 企业内部应用申请特殊权限需要在邮件正文中附带应用下载二维码，并提供应用登录测试帐号。
• 如果您在申请或接入过程中遇到任何问题，可通过小米推送客服系统反馈。

3、使用规范

3.1、权限使用规范

应用在获得Voip Service Kit 功能使用权限后，需严格按照小米推送《接入文档》的要求调用接口，不得超范围使用（如将功能用于非申请场景），具体参见小米《推送运营规范》（五、推送消息行为规范，第（四）、（五）、（六）点）。

3.2、不定期核查

小米推送会不定时对已开通Voip Service Kit 功能的应用进行合规性及服务质量核查，若发现违规或质量不达标，将暂停权限并要求限期整改。违规处理参见小米《推送运营规范》（六、违规处理）。

3.3、 变更申请

若应用的使用场景、服务范围发生变更，需提前15个工作日发送【变更申请】邮件（邮件模板同上），审核通过后方可调整。