推送消息说明

一、推送方式

1.推送说明

开放平台向接入商推送实时的业务变更消息，保持数据的一致性以及同步，满足接入商业务需求，避免轮询。推送的数据消息，将以http post（自行在开放平台配置回调地址）的方式向该推送地址发起调用，把数据推送给接入商。接入商接收消息，需要回执（参见回执）。接收失败时，消息中心会自动重发（参见生命周期）

2.生命周期

一般情况下，1小时以内完成4次通知（通知的间隔频率一般是：立即, 4m,10m,10m,1h

3.回执

如果收到消息，并处理成功，返回如下json字符串

{
    "code": 1
}

除此之外，都会判定为失败，当失败时，会根据生命周期，重新通知或停止通知

4.幂等处理

由于消息存在重试机制，同一消息（相同id）可能多次发送（网络原因、商户服务器原因、或者商户接受处理成功但并未按要求回执等），消息接收方需要对同一个id的多次消息投递实现幂等。若之前相同的id已处理成功直接返回成功回执即可；

5.安全处理

上线后需要通过传递的签名是否正确来判断推送安全

6.建议处理方式

建议收到商品上架、变更消息时调取商品接口同步商品最新详情、属性、规格信息。

二、推送格式

消息数据以Json格式发送，消息提供统一的模板；不同业务的消息，仅通过消息类型来区分，具体的业务消息内容，参考各个业务消息说明。

1.消息模板参数说明

参数	类型	可选	说明	备注
id	number	必须	每次推送唯一	如202001010101011111
push_time	number	必须	推送时间	1970.1.1到现在的毫秒数
type	string	必须	消息类型	如order.refund.agree
data	object	必须	体推送的业务消息数据，字段说明，参考各个业务消息说明	如{"key1":"value1"}
sign	string	必须	签名	0337D2B8752231B729927A36F98C6849
appID	string	必须	账户id	1543
times	string	必须	推送次数	1,2,3
createTime	string	必须	创建时间	时间戳
responseStatus	string	必须	客户响应状态	0失败1成功

2.订单消息模板json示例

{
"id": 202001010101011111,
"pushTime": 1392711616045,
"data": {
"orderSn": "1234567890"
},
"type": "order.refund.agree"
}

3.商品消息模板json示例

{
"id": 202001010101011111,
"pushTime": 1392711616045,
"data": {
"goodsIds": [1234567890]//SPUID 商品ID
},
"type": "goods.alter"
}

4.消息签名

发送推送时header会发送签名用于验证，如下参数

sign: A8D9EA079A8F034736114967F7B410E4

签名计算规则

1.将回调的json后拼接secretKey

例如回调参数如下：

{"app_id":1,"data":{"goodsIds":[35137323]},"id":"20220726183234895644000545","push_time":1658831554895,"times":1,"type":"goods.on.sale"}

2. 拼接secretKey

例：
{"app_id":1,"data":{"goodsIds":[35137323]},"id":"20220726183234895644000545","push_time":1658831554895,"times":1,"type":"goods.on.sale"}123stbz456

3.对上一步结果进行sha1加密
例：
621c0815f654fea5ea0091409101c57d2c555b10
4.对上一步结果进行md5加密，得到32进制字符串
例：
a8d9ea079a8f034736114967f7b410e4
5.将上一步结果转为大写
例：
A8D9EA079A8F034736114967F7B410E4

消息说明

推送消息说明#

一、推送方式#

1.推送说明#

2.生命周期#

3.回执#

4.幂等处理#

5.安全处理#

6.建议处理方式#

二、推送格式#

1.消息模板参数说明#

2.订单消息模板json示例#

3.商品消息模板json示例#

4.消息签名#

发送推送时header会发送签名用于验证，如下参数#

签名计算规则#

1.将回调的json后拼接secretKey#

2. 拼接secretKey#