文档管理中心
您当前正在浏览HarmonyOS 3.1/4.0及以下版本的文档,如需查阅HarmonyOS 5.0及以上文档请参考API参考。
API参考推送服务REST上行消息

上行消息

注意

为了更安全的网络访问,华为推送服务于2022年11月30日关闭Push相关域名的TLS1.0、TLS1.1协议及规定之外的加密套件,关闭后,应用使用TLS1.2以下协议或使用规定外的加密套件将无法正常推送消息。

若您的应用访问Push相关域名使用协议是TLS1.0或TLS1.1,后续可能无法正常发送消息,请您务必升级到TLS1.2及以上版本。

调整指导请查阅《Push Kit相关域名的TLS1.0和TLS1.1协议关闭通知》,如您有任何疑问,请联系技术支持,感谢您对华为推送的支持。

功能介绍

华为Push服务器通过HTTPS方式调用此接口给您的服务器推送上行消息。

接口约束

无

接口原型

承载协议

HTTPS POST

接口方向

HUAWEI Push服务器 -> 开发者服务器

接口URL

您的服务器接收上行消息的地址,由您定义,同AppGallery Connect上配置的接收地址一致。

数据格式

请求消息:Content-Type: application/json

响应消息:Content-Type: application/json

请求参数

Request Header

展开

参数名

取值描述

样例

X-HW-SIGNATURE

消息头签名参数,必选字段,代表发送给您的服务器的签名信息。

timestamp=1563105451261; nonce=:; value=E4YeOsnMtHZ6592U8B9S37238E+Hwtjfrmpf8AQXF+c=

  • timestamp为标准unix时间戳
  • nonce为英文冒号
  • value为待加密字符串

(timestamp+nonce+上行消息内容)使用回调秘钥进行HmacSHA256加密后,再经Base64编码后获得。

X-HW-TIMESTAMP

消息头时间戳参数,必选字段,代表华为服务器收到上行消息的时间。

1563105451261

Request Body

展开

参数

是否必选

参数类型

描述

from

是

String

发送上行消息的客户端应用的Token。

category

是

String

发送上行消息的应用的包名。

message_id

是

String

由端侧应用自己生成,保证应用内唯一的消息ID。

data

否

String

消息有效负载的键值对。字段内容需要加密,base64处理。

请求示例

无

响应参数

Response Body

展开

参数

参数类型

描述

errno

String

您的服务端返回的处理结果状态。

errmsg

String

您处理结果的描述信息。

响应示例

无

在 API参考 中进行搜索
请输入您想要搜索的关键词