Weibo Platform Logo

微博开放平台

weibo
跳转到： 导航, 搜索
第61行： 第61行：
 
|true
 
|true
 
|string
 
|string
−
|通知内容，为JSON字符串，通过 type 判断业务类型，不同业务类型数据格式不同，具体字段见下面的说明。
+
|通知内容，为JSON字符串，通过 type 判断业务类型，不同业务类型数据格式不同，具体字段见下面的 通知内容 说明。
 +
|}
 +
</div>
 +
 
 +
 
 +
<div class="code_type">通知内容</div>
 +
<div style="margin:15px 0;">
 +
子订单事件，type = 2
 +
</div>
 +
<pre class="brush:js">
 +
{
 +
    "recharge_account_type": "3",
 +
    "recharge_account": "1234567890",
 +
    "sub_order_id": "366383890000352",
 +
    "state_code": 202,
 +
    "addtime": "2022-07-21 12:15:02",
 +
    "pay_time": "1970-01-01 00:00:00",
 +
    "buyer_id": "1766",
 +
    "sku_list": [
 +
        {
 +
            "goods_id": "1083814100038",
 +
            "sku_id": "3924",
 +
            "state_code": 502,
 +
            "sold_state_code": 601,
 +
            "pin": ""
 +
        }
 +
    ],
 +
    "buyer": {
 +
        "weibo_uid": "6748678500"
 +
    }
 +
}
 +
</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%"|字段说明描述
 +
|-
 +
|recharge_account_type
 +
|int
 +
|充值账号类型，1 - 手机号码，2 - QQ账号，3 - 微信昵称。
 +
|-
 +
|recharge_account
 +
|string
 +
|充值账号。
 +
|-
 +
|sub_order_id
 +
|int64
 +
|子订单ID。
 +
|-
 +
|state_code
 +
|int
 +
|订单状态码，详见 [[ecs/code_index|电商服务商开发编码索引]]。
 +
|-
 +
|addtime
 +
|date time
 +
|创建时间。
 +
|-
 +
|pay_time
 +
|date time
 +
|支付时间。
 +
|-
 +
|buyer_id
 +
|int
 +
|买家ID。
 +
|-
 +
|sku_list
 +
|object array
 +
|子订单商品信息列表。
 +
|-
 +
|goods_id
 +
|int64
 +
|SPU ID。
 +
|-
 +
|sku_id
 +
|int
 +
|SKU ID。
 +
|-
 +
|state_code
 +
|int
 +
|SKU正向状态码。
 +
|-
 +
|sold_state_code
 +
|int
 +
|SKU逆向状态码。
 +
|-
 +
|pin
 +
|int
 +
|PIN码。
 +
|-
 +
|buyer
 +
|object
 +
|买家信息。
 +
|-
 +
|weibo_uid
 +
|string
 +
|买家微博UID。
 
|}
 
|}
 
</div>
 
</div>
第80行： 第177行：
 
{|width="100%" border="0" cellspacing="0" cellpadding="0" class="wiki_table"
 
{|width="100%" border="0" cellspacing="0" cellpadding="0" class="wiki_table"
 
<html><colgroup></colgroup></html>
 
<html><colgroup></colgroup></html>
−
!width="20%"|返回值字段
+
!width="20%"|返回字段
 
!width="20%"|类型
 
!width="20%"|类型
 
!width="60%"|字段说明描述
 
!width="60%"|字段说明描述
第103行： 第200行：
  
 
<div style="margin:15px 0;">
 
<div style="margin:15px 0;">
−
请登录 [https://sj.e.weibo.com/ 商家端] 设置完善事件通知接收请求地址
+
请登录微博电商平台 [https://sj.e.weibo.com/ 商家端] ，设置事件通知接收请求地址。
 
</div>
 
</div>
  

2023年2月2日 (四) 16:35的版本

电商商家事件通知推送

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


接入流程

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


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 判断业务类型，不同业务类型数据格式不同，具体字段见下面的 通知内容 说明。


通知内容

子订单事件，type = 2 

{
    "recharge_account_type": "3", 
    "recharge_account": "1234567890", 
    "sub_order_id": "366383890000352", 
    "state_code": 202, 
    "addtime": "2022-07-21 12:15:02", 
    "pay_time": "1970-01-01 00:00:00", 
    "buyer_id": "1766", 
    "sku_list": [
        {
            "goods_id": "1083814100038", 
            "sku_id": "3924", 
            "state_code": 502, 
            "sold_state_code": 601, 
            "pin": ""
        }
    ], 
    "buyer": {
        "weibo_uid": "6748678500"
    }
}
推送字段 类型 字段说明描述
recharge_account_type int 充值账号类型，1 - 手机号码，2 - QQ账号，3 - 微信昵称。
recharge_account string 充值账号。
sub_order_id int64 子订单ID。
state_code int 订单状态码，详见 电商服务商开发编码索引。
addtime date time 创建时间。
pay_time date time 支付时间。
buyer_id int 买家ID。
sku_list object array 子订单商品信息列表。
goods_id int64 SPU ID。
sku_id int SKU ID。
state_code int SKU正向状态码。
sold_state_code int SKU逆向状态码。
pin int PIN码。
buyer object 买家信息。
weibo_uid string 买家微博UID。


请求响应

接入的商家收到事件通知后，需要按如下JSON格式返回相应 

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


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

请登录微博电商平台 商家端 ，设置事件通知接收请求地址。


注意事项

不保证消息顺序。


不保证中间态消息不丢失（仅保证终态消息不丢失）。


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


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


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


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


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





来自“http://open.weibo.com/wiki/index.php?title=Eshop/push&oldid=16481”

关于微博开放平台| 联系我们| 服务条款| 无线游戏| 开放平台官微

京网文 [2011] 0398-130号 京ICP证100780号 Copyright © 1996-2024 SINA