商家店铺授权给开发者

当开发者获取商家的店铺订单等数据时,商家需要授权给开发者,商家先订购千里马,然后再做授权 。

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

京东服务市场订购:

https://fw.jd.com/main/detail/FW_GOODS-1581601

通过授权链接完成授权

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

授权链接格式为:

https://kf.fw199.com/partner/jdgrant?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/jdgrant?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/jdgrant?appid=38lsDeiaqpjpLsAA&callback=https%3A%2F%2Fwww.baidu.com%2Fh7b%2Fcallback%3Fuserid%3D100

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

2 授权回调

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

调回url类似如下 :

https://www.baidu.com/h7b/authback?jdseller=12412981&token=5ae5e80fe6644923b4d34dffc91bd79clnwu&jduserid=12412981&deadline=2023-03-09%2015:37:45&shopname=依迪筱童装旗舰店

回调参数说明

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

生成token的Java代码,此token只是用检验本次回调请求来自蜂巢。

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

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

文档更新时间: 2024-02-17 14:29   作者:admin