商家店铺授权给开发者

当开发者获取商家的店铺订单时,商家需要授权给开发者。授权有2种方式, 分别是授权链接和授权码方式. 由于抖店本身的机制, 对于新订购的用户(首次授权时,会丢失state参数,不能跳回授权回调地址), 如果对这方面有要求的场景,可以通过授权码方式完成授权.

开发者提供授权链接,让商家点击跳去授权 。

抖店服务市场订购: https://fuwu.jinritemai.com/detail?service_id=23042

一.通过授权链接完成授权

开发者可在自己的网站添加授权入口,让商家点击下面的授权链接,商家使用自己的抖店账号登录后,再进行授权,授权完成后,蜂巢开放平台会回调开发者的网站,并将授权的商家账号及订购时间传回。

授权链接格式为:

https://kf.fw199.com/partner/ddomsgrant?appid=Your_AppId&callback=Your_CallBackUrl

上述拼接授权URL相关参数说明:

参数名称 是否必选 参数说明 示例
appid 必选 开发者AppId 38lsDeiaqpjpLsAA ,请改为开发者自己的AppId
callback 可选 开发者的回调url , url应以http或https开头,回调url可以附带开发者的自定义参数(回调时会原样返回),商家授权完成后,蜂巢系统会将页面重定向到此url, 此url需要进行UrlEncode

1 授权链接示例

1.1 不带参数情况

假如您的appid为38lsDeiaqpjpLsAA, 网站的回调url为: https://www.baidu.com/h7b/authback ,对此url进行encode
后得到https%3A%2F%2Fwww.baidu.com%2Fh7b%2Fauthback, 则完整的授权链接为

https://kf.fw199.com/partner/ddomsgrant?appid=38lsDeiaqpjpLsAA&callback=https%3A%2F%2Fwww.baidu.com%2Fh7b%2Fauthback

1.2 带参数情况

假如您的appid为38lsDeiaqpjpLsAA, 网站的回调url为: https://www.baidu.com/h7b/callback?userid=100 ,对此url进行UrlEncode
后得到https%3A%2F%2Fwww.baidu.com%2Fh7b%2Fcallback%3Fuserid%3D100, 则完整的授权链接为

https://kf.fw199.com/partner/ddomsgrant?appid=38lsDeiaqpjpLsAA&callback=https%3A%2F%2Fwww.baidu.com%2Fh7b%2Fcallback%3Fuserid%3D100

在授权回调时,蜂巢除了返回商家信息字段之外,同时会原样附加上开发者授权传入的参数,如上面的userid=100。

2 授权回调

商家在抖店授权页面,点同意授权后,蜂巢平台会重定向到开发者授权Url中传入的回调网址callback,并同时附上doudianseller、doudianuserid 参数,参数需要urlDecode。
调回url类似如下 :

https://www.baidu.com/?doudianseller=oms2726558&token=89d124e19d927ebb4405ec5f6b29add7&doudianuserid=2726558&deadline=2023-06-29%2011%3A56%3A11&shopname=%E6%B8%A9%E5%B7%9E%E5%B8%82%E7%93%AF%E6%B5%B7%E6%B3%BD%E9%9B%85%E9%87%91%E4%B8%8B%E5%B7%B4%E6%9C%8D%E9%A5%B0%E7%BD%91%E5%BA%97

回调参数说明

参数名称 参数说明 示例
doudianseller 授权的抖店商家账号,注意不是商家的店铺名, 后续调用蜂巢接口,seller_nick商家账号用此值传入 oms2726558
doudianuserid 授权的抖店商家账号Id, 2726558
token 蜂巢平台返回校验值,可用于判断本次回调是否是来自蜂巢。 采用md5(appSecret+ doudianuserid+ appSecret)生成,建议开发者在自己侧使用平台分配的密钥生成并进行匹配token。 346938e31fbb7342acbcf2e61f1684a9
deadline 此授商家订购抖店千里马打单服务截止时间,需要UrlDecode。 比如2021-02-13+00%3A00%3A00 ,进行UrlDecode后,得到2021-02-13 00:00:00
shopname 此授权商家的店铺名称,需要UrlDecode。

生成token的Java代码

 String token = Utils.MD5(Config.AppSecret + doudianuserid + Config.AppSecret);

说明:Config.AppSecret为平台分配给开发者的密钥。

2.1 授权接口返回

授权成功的情况下, 页页返回

 {
    "code": 0,
    "message": "ok",
    "data": {
        "doudianuserid": 2726558,  // 店铺ID
        "doudianseller": "oms2726558",   // 店铺账号,后续调用抖店接口时用此值
        "shopname": "永康服饰网店",  // 店铺名称
        "deadline": "2023-06-29 11:56:11"  // 店铺订购千里马应用的到期时间
    },
    "trace_id": ""
}

说明: code为0表示成功,非0为失败,message会包含失败原因。

文档更新时间: 2024-06-17 15:02   作者:admin