【热】API调用返回成功状态，但未收到消息是何原因？⭐️
当 API 推送接口返回成功状态，但设备端未收到消息时，建议从以下几个方面进行排查：
一、设备端排查
通知权限设置
检查设备是否关闭了通知栏权限，请确保应用的通知功能已开启；
Android 用户可进入【设置 > 应用管理 > 通知管理】中确认；
iOS 用户可进入【设置 > 通知】中确认。
安全中心限制
部分 Android 厂商（如小米、华为、OPPO）的安全中心可能会限制后台服务或推送通道；
请检查并开启【后台服务权限】、【通知权限】等安全中心通知相关必要设置。
客户端集成问题
查看客户端日志，确认是否接收到推送消息；
若有错误日志，请定位是否为通道连接异常、消息解析失败等问题。
iOS 推送证书问题（仅 iOS）
确保推送证书有效，且与当前环境（开发/生产）匹配；
若证书过期或配置错误，将导致 iOS 设备无法接收消息。
二、后台记录查询
如果 API 推送成功但后台未查询到推送记录，请根据以下分类进行查询：
1. API 单播（非任务类消息）
消息类型： 单播（unicast）、列播（listcast）、自定义播（customizedcast 且不带 file_id）；
查询路径： 推送 > 推送记录 > API 单播；
注意事项：
后台仅展示 T+1 数据，即前一天的汇总统计；
不展示单条设备推送明细，如需获取明细数据，请升级至 U-Push 付费版（专业版/尊享版）；
统计基于设备上报时间，可能存在一定延迟。
2. API 批量任务（任务类消息）
消息类型： 广播（broadcast）、文件播（filecast）、组播（groupcast）、自定义播（customizedcast 且带 file_id）；
查询路径： 推送 > 推送记录 > 通知消息 / 自定义消息 > 推送方式选择 API；
支持操作： 查看每条任务推送的详细统计结果，支持 API 查询与撤销操作。
三、其他建议
如需获取每条推送的设备级回执与明细数据，建议购买 U-Push 专业版或尊享版服务；
更多技术细节，请参考文档：《调用 API 接口返回成功，但设备却没有收到消息怎么办？》