目录

发送下行消息

推送服务支持您使用HTTPS协议接入Push服务端,HTTPS协议通道提供上行消息和下行消息能力。本章节介绍发送下行消息的能力。

下行消息交互图如下所示:

  1. 您的服务端获取鉴权信息,可以通过OAuth 2.0开放鉴权(客户端模式)或者基于服务账号生成鉴权令牌(JSON Web Token)方式。
  2. 您的服务端调用API发送Push消息,更多消息体内容请参见下行消息,相关错误码请参见错误码。

    HTTPS POST URL:

    POST https://push-api.cloud.huawei.com/v1/[clientid]/messages:send

    “[clientid]”请替换为您应用的Client ID(在项目设置页面获取)。

    调用API推送消息时,接口URL版本为V1(https://push-api.cloud.huawei.com/v1/[clientid]/messages:send)和V2(https://push-api.cloud.huawei.com/v2/[projectid]/messages:send)时,仅支持给HarmonyOS 3.x/4.x的系统版本推送通知。如果您想给HarmonyOS Next/5.x及之后的系统版本推送通知,请使用V3 版本URL(https://push-api.cloud.huawei.com/v3/[projectId]/messages:send)。

    请求消息头示例:

    Content-Type: application/json; charset=UTF-8
    Authorization: Bearer CF3Xl2XV6****************************************Nm3WccUIaDg== 
    通知栏消息体示例:
    {
        "validate_only": false,
        "message": {
            "android": {
                "notification": {
                    "title": "test title",
                    "body": "test body",
                    "click_action": {
                        "type": 3
                    }
                }
            },
            "token": ["pushtoken1"]
        }
    }
    透传消息体示例:
    {
        "validate_only": false,
        "message": {
            "data": "{'param1':'value1','param2':'value2'}",
            "token": ["pushtoken1"]
        }
    }

    消息体字段详情请参见下行消息请求参数。

  3. 您的应用服务器接收Push消息回执,详细请参见消息回执。

推送服务提供了服务端示例代码对服务端接口进行封装,方便您参考使用。