| 第77行： | 第77行： | ||
} | } | ||
</pre> | </pre> | ||
| + | <div style="margin:15px 0;"> | ||
| + | {|width="100%" border="0" cellspacing="0" cellpadding="0" class="wiki_table" | ||
| + | <html><colgroup></colgroup></html> | ||
| + | !width="20%"|返回值字段 | ||
| + | !width="20%"|类型 | ||
| + | !width="60%"|字段说明描述 | ||
| + | |- | ||
| + | |code | ||
| + | |int | ||
| + | |必需返回，返回状态码，0-正常，其他为异常。 | ||
| + | |- | ||
| + | |msg | ||
| + | |string | ||
| + | |可选是否返回，返回的错误提示。 | ||
| + | |- | ||
| + | |data | ||
| + | |json object | ||
| + | |可选是否返回，返回的错误数据。 | ||
| + | |} | ||
| + | </div> | ||
| 第83行： | 第103行： | ||
<div style="margin:15px 0;"> | <div style="margin:15px 0;"> | ||
| − | 请登录 | + | 请登录 [https://sj.e.weibo.com/ 商家端] 设置完善事件通知接收请求地址 |
</div> | </div> | ||
2023年2月2日 (四) 16:19的版本
电商商家事件通知推送
事件通知是由微博电商平台通知接入的商家，目前主要为订单事件通知，仅限虚拟商家接入。
接入流程
接入的商家需要根据自身业务的情况，维护自己的订单状态服务器。
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次方）分钟。
业务方需要根据自身业务处理相关异常。
