跳转到: 导航, 搜索

电商商家自研接入

微博电商商家账号自研接入,主要面对的是有自主开发能力的商家,区别于电商服务商应用,商家自研接入是商家自己开发自己使用,不能提供给其他商家使用。


电商服务商接入,区别于电商商家自研接入,是给电商商家提供服务的第三方服务商,请移步 电商服务商接入


基础能力

目前主要提供商家账号自主接入微博电商服务时,获取自身商家账号授权 access_token 的能力。


授权登录,获取 access_token

电商商家应用,自身商家账号授权的 access_token 是其唯一的接口调用凭证,电商商家在自研接入微博电商服务中,调用各接口时都需使用这个access_token,开发者需要在服务端妥善保存好 access_token,不应将其保存到应用前端。


电商商家自身授权的 access_token 和网页应用、移动应用获得的 access_token 有所不同,电商商家自身授权获得的 access_token 有效期为2个小时,需定时刷新,重复获取将导致上次获取的 access_token 失效。


电商商家账号,在自研接入微博电商服务时,可以通过电商商家自研接入的 appkey 和 appsecret 直接调用下面的接口,来获取电商商家自身授权的 access_token。


电商商家自研接入,如果有需要获取其他微博用户授权的场景,需要按网页应用的两步授权流程来处理,即通过 oauth2/authorize、oauth2/access_token 接口,首先请求其他微博用户的授权,在对方同意并点击授权后得到授权 code,再通过服务端用授权 code 换取授权 access_token。


电商商家自研接入获取授权接口

获取自身电商商家账号的授权 token


接口 URL
https://api.weibo.com/oauth2/shop/authorize


HTTP 请求方式

GET


请求参数
参数名称 是否必填 类型 说明描述
client_id true string 电商商家在微博开放平台申请的【电商商家自研接入 APPKEY】。
timestamp true string 当前时间戳(毫秒)。
nonce true string 随机字符串。
sign true string 签名:md5(client_id&developer_uid&timestamp&nonce&secret)。

注:其中 client_id 为电商商家在微博开放平台申请的【电商商家自研接入 APPKEY】,developer_uid 为开发者,即电商商家账号的微博UID。


返回结果 JSON 示例
{
    "client_id": "772915",
    "uid": 1404376560,
    "access_token": "2.00lnqNgH0YhE_q6594efd4abyzYM7E",
    "issued_at": 1655101652,
    "expires_in": 2637148
}


返回字段说明
返回值字段 类型 字段说明描述
client_id string 电商商家在微博开放平台申请的【电商商家自研接入 APPKEY】。
uid string 授权用户的微博 UID,实际上就是电商商家账号自己的UID。
access_token string 授权的【电商商家授权 access_token】,用于调用电商商家开放接口。
issued_at string access_token 的生成的时间戳。
expires_in string access_token 的生命周期,单位是秒数。


电商商家获得自身商家账号授权后,开发者应在服务端统一维持 access_token 的有效期,并保存好 access_token ,调用微博开放接口也应在服务端完成,不要将 access_token 传递到前端,也不要在前端发起调用微博开放接口,服务端各业务之间也不要分别去刷新 access_token,以免冲突,造成相互之间覆盖 access_token,影响调用接口。


平台能力

提供给电商商家的平台能力,目前包含订单能力接口、商品能力接口。






文档更新时间: 2022-11-10