跳转到: 导航, 搜索

电商商家事件通知推送

事件通知是由微博电商平台通知接入的商家,目前主要为订单事件通知,仅限虚拟商家接入。


接入流程

接入的商家需要根据自身业务的情况,维护自己的订单状态服务器。


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": {}
}
返回值字段 类型 字段说明描述
code int 必需返回,返回状态码,0-正常,其他为异常。
msg string 可选是否返回,返回的错误提示。
data json object 可选是否返回,返回的错误数据。


2、设置事件通知接收请求地址

请登录 商家端 设置完善事件通知接收请求地址


注意事项

不保证消息顺序。


不保证中间态消息不丢失(仅保证终态消息不丢失)。


接口性能必需在200ms内,超时将按照补偿策略通知(补偿通知不保证时效)。


接口需要保证幂等(可能发起重复通知)。


首次通知会在2分钟内送达(99.99%的通知会在1分钟内送达)。


首次通知超时、失败,则会进行补偿通知。补偿通知最多11次,每次延时(2的N次方)分钟。


业务方需要根据自身业务处理相关异常。