电商商家事件通知推送
事件通知是由微博电商平台通知接入的商家,目前主要为订单事件通知,仅限虚拟商家接入。
接入流程
接入的商家需要根据自身业务的情况,维护自己的订单状态服务器。
1、开发事件通知接收请求地址
接入的自研商家,需要先开发一个用来接收事件通知的请求地址,当有事件通知时,微博电商平台将调用这个请求地址,将事件通知发送给接入的商家。
请求方式
POST
内容类型
Content-Type 为 application/x-www-form-urlencoded
请求参数
参数名称 | 是否必填 | 类型 | 说明描述 |
---|---|---|---|
sign | true | string | 验证签名,签名算法见 电商接口验证签名。 |
type | true | int | 业务类型,2 - 子订单。 |
time | true | int | 10位秒级时间戳。 |
data | true | string | 通知内容,为JSON字符串,通过 type 判断业务类型,不同业务类型数据格式不同,具体字段见下面的说明。 |
请求响应
接入的商家收到事件通知后,需要按如下JSON格式返回相应
{ "code": 0, "msg": "", "data": {} }
2、设置事件通知接收请求地址
请登录 [[1]] 设置完善事件通知接收请求地址
注意事项
不保证消息顺序。
不保证中间态消息不丢失(仅保证终态消息不丢失)。
接口性能必需在200ms内,超时将按照补偿策略通知(补偿通知不保证时效)。
接口需要保证幂等(可能发起重复通知)。
首次通知会在2分钟内送达(99.99%的通知会在1分钟内送达)。
首次通知超时、失败,则会进行补偿通知。补偿通知最多11次,每次延时(2的N次方)分钟。
业务方需要根据自身业务处理相关异常。