查询离线推送结果统计数据

要查询离线推送结果，你需要联系环信商务开通该功能。该功能开通后，环信离线推送服务会产生推送结果消息。

离线推送结果查询方式

你可以通过以下方式查询离线推送的结果：

• 在环信控制台上查看 IM 消息投递查询：
  • 在 应用列表 中点击目标应用的 操作 栏中的 管理 按钮，进入 应用概览 页面。
  • 选择 即时通讯 > 实时查询 > IM消息投递查询，查看推送结果记录，如下图所示：

• 推送结果回调：创建发送后回调规则，对于回调类型参数选择离线推送事件，然后选择推送成功、推送失败或推送异常，即可接收到推送结果消息回调内容。关于离线推送事件，详见发送后回调事件。

• 调用 RESTful API 查询离线推送结果统计。

调用 RESTful API 查询离线推送结果统计数据

调用频率上限

10 次/10 秒/App Key

请求 URL

GET https://{host}/{org_name}/{app_name}/push/data/offline-push/begin/{startTime}/end/{endTime}?platform={ALL}

参数	类型	是否必需	描述
startTime	String	是	查询数据的开始时间，格式为 yyyy-MM-dd，例如，2024-04-01。
endTime	String	是	查询数据的结束时间，格式为 yyyy-MM-dd，例如，2024-04-02。
platform	enum	是	查询的平台，取值如下： - （默认）ALL：查询所有推送平台的推送统计结果。 - APNS：APNs 推送； - ANDROID：FCM 推送； - XIAOMIPUSH：小米推送； - HUAWEIPUSH：华为推送 - MEIZUPUSH：魅族推送； - OPPOPUSH：OPPO 推送； - VIVOPUSH：vivo 推送； - HONOR：荣耀推送。

关于请求 URL 中的参数说明，详见 请求 URL 参数介绍。

请求示例

将 <YourAppToken> 替换为你在服务端生成的 App Token
curl -g -X GET 'https://XXXX/XXXX/XXXX/push/data/offline-push/begin/2024-04-01/end/2024-04-02?platform=ALL' \
-H 'Authorization: Bearer <YourAppToken>

请求 header 参数

参数	类型	描述	是否必需
Authorization	String	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。	是

响应示例

{
    "status": "OK",
    "data": {
        "2024-04-02": {
            "HONOR": {
                "successCount": 7218,
                "failCount": 239
            },
            "HUAWEIPUSH": {
                "successCount": 48852,
                "failCount": 1969
            },
            "OPPOPUSH": {
                "successCount": 66226,
                "failCount": 3774
            },
            "VIVOPUSH": {
                "successCount": 42380,
                "failCount": 2189,
                "arriveCount": 40559
            },
            "XIAOMIPUSH": {
                "successCount": 23071
            }
        },
        "2024-04-01": {
            "HONOR": {
                "successCount": 8306,
                "failCount": 1208
            },
            "HUAWEIPUSH": {
                "successCount": 55933,
                "failCount": 1335
            },
            "OPPOPUSH": {
                "successCount": 76026,
                "failCount": 4534
            },
            "VIVOPUSH": {
                "successCount": 52091,
                "failCount": 3042,
                "arriveCount": 49623
            },
            "XIAOMIPUSH": {
                "successCount": 26364
            }
        }
    }
}

响应 body 字段

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

参数	类型	描述
status	String	请求状态。若请求成功，返回 OK。
data	JSON	离线推送结果。
data.successCount	Int	成功发送的离线推送通知数量。
data.failCount	Int	发送失败的离线推送通知数量。
data.arriveCount	Int	送达到接收方的离线推送通知的数量。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考 错误码 了解可能的原因。

错误码

如果返回的 HTTP 状态码非 200，表示请求失败，可能提示以下错误码：

HTTP 状态码	错误类型	错误提示	可能原因	处理建议
403	forbidden_op		查询离线推送结果统计的功能未开通。	联系环信商务开通该功能。
401	unauthorized	Unable to authenticate (OAuth)	token 不合法，可能过期或 token 错误。	使用新的 token 访问。

关于其他错误，你可以参考 响应状态码 了解可能的原因。