商家店铺授权给开发者
当开发者获取商家的店铺订单等数据时,商家需要授权给开发者,商家先订购千里马,然后再做授权 。
开发者提供授权链接,让商家点击跳去授权 。
京东服务市场订购:
通过授权链接完成授权
开发者可在自己的网站添加授权入口,让商家点击下面的授权链接,商家使用自己的拼多多账号登录后,再进行授权,授权完成后,蜂巢开放平台会回调开发者的网站,并将授权的商家账号及订购时间传回。
授权链接格式为:
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, 则完整的授权链接为
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, 则完整的授权链接为
在授权回调时,蜂巢除了返回商家信息字段之外,同时会原样附加上开发者授权传入的参数,如上面的userid=100。
2 授权回调
商家在抖店授权页面,点同意授权后,蜂巢平台会重定向到开发者授权Url中传入的回调网址callback,并同时附上jdseller、jduserid 参数,参数需要urlDecode。
调回url类似如下 :
回调参数说明
参数名称 | 参数说明 | 示例 |
---|---|---|
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为平台分配给开发者的密钥。