文档首页 > > API参考> API> Application直发消息操作> App消息发布

App消息发布

分享
更新时间: 2019/09/16 GMT+08:00

功能介绍

  • 接口名称

    PublishAppMessage

  • 功能描述

    将消息直发给endpoint设备。

URI

  • URI格式

    POST /v2/{project_id}/notifications/endpoints/{endpoint_urn}/publish

  • 参数说明

    名称

    是否必选

    参数类型

    说明

    project_id

    String

    项目ID

    获取项目ID请参考获取项目ID

    endpoint_urn

    String

    Endpoint的唯一资源标识,可通过查询Application的Endpoint列表获取该标识。

请求消息

  • 参数说明

    名称

    是否必选

    参数类型

    说明

    message

    String

    app推送的消息内容,当前支持的推送平台有HMS、APNS、APNS_SANDBOX。

    • HMS是为开发者提供的消息推送平台
    • APNS和APNS_SANDBOX是用于推送iOS消息的服务平台。
    • HMS平台指定的消息内容不超过2K
    • APNS和APNS_SANDBOX平台的消息内容不能超过4K

    推送平台的消息内容格式要求详情见application消息体格式

    time _to_live

    String

    消息发送的生存时间,是相对于发布时间的。

    SMN系统将移动推送消息转交给推送平台前,会计算该消息在系统消耗的时间。只有消耗的时间小于time_to_live时SMN才会将消息转交给推送平台,并将time_to_live减去消耗的时间传递给推送平台,否则消息废弃。

    time _to_live的单位是s,变量默认值是3600s,即一小时。值为正整且小于等于3600*24*7。

  • 请求样例
    POST https://{SMN_Endpoint}/v2/{project_id}/notifications/endpoints/{endpoint_urn}/publish
    {
        "message":{
             "hps":{
                   "msg":{
                         "action":{ 
                               "param":{
                                    "intent":"#Intent;compo=com.HC.SmnAppPush.defaultAction/.Activity;S.W=U;end"
                               },
                               "type":1
                         },
                         "body":{
                               "title":"hello world",
                               "content":"hello world"
                         },
                         "type":3
                    }
             }
        }
    }

响应消息

  • 要素说明

    名称

    参数类型

    说明

    request_id

    String

    请求的唯一标识ID。

    message_id

    String

    唯一的消息ID。

  • 响应样例
    { 
        "message_id": "bf94b63a5dfb475994d3ac34664e24f2", 
        "request_id": "9974c07f6d554a6d827956acbeb4be5f" 
    }

返回值

请参考返回值

错误码

请参考错误码说明

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区