商家店铺授权给开发者
当开发者获取商家的店铺订单时,商家需要授权给开发者。 开发者提供授权链接,让商家点击跳去授权 。
快手服务市场订购: https://fuwu.kwaixiaodian.com/new/detail?id=20706128191236
1. 准备给商家的授权链接
开发者可在自己的网站添加授权入口,让商家点击下面的授权链接,商家使用自己的快手账号登录后,再进行授权,授权完成后,蜂巢开放平台会回调开发者的网站,并将授权的商家账号及订购时间传回。
授权链接格式为:
https://kf.fw199.com/partner/ksgrant?appid=Your_AppId&callback=Your_CallBackUrl
上述拼接授权URL相关参数说明:
参数名称 | 是否必选 | 参数说明 | 示例 |
---|---|---|---|
appid | 必选 | 开发者AppId | 38lsDeiaqpjpLsAA ,请改为开发者自己的AppId |
callback | 可选 | 开发者的回调url , url应以http或https开头,回调url可以附带开发者的自定义参数(回调时会原样返回),商家授权完成后,蜂巢系统会将页面重定向到此url, 并同时在url中增加返回参数seller和token。 此url需要进行UrlEncode |
2 授权链接示例
2.1 不带参数情况
假如您的appid为38lsDeiaqpjpLsAA, 网站的回调url为: https://www.baidu.com/h7b/authback ,对此url进行encode
后得到https%3A%2F%2Fwww.baidu.com%2Fh7b%2Fauthback, 则完整的授权链接为
2.2 带参数情况
假如您的appid为38lsDeiaqpjpLsAA, 网站的回调url为: https://www.baidu.com/h7b/callback?userid=100 ,对此url进行UrlEncode
后得到https%3A%2F%2Fwww.baidu.com%2Fh7b%2Fcallback%3Fuserid%3D100, 则完整的授权链接为
3 授权回调
商家在快手授权页面,点同意授权后,蜂巢平台会重定向到开发者授权Url中传入的回调网址callback,并同时附上pddseller、token 参数。
调回url类似如下:
回调参数说明
参数名称 | 参数说明 | 示例 |
---|---|---|
seller | 授权的快手商家账号, 后续调用蜂巢接口中seller_nick字段即为此字段 | |
userid | 授权的快手商家账号Id, | 75750622154 |
token | 蜂巢平台返回校验值,可用于判断本次回调是否是来自蜂巢。 采用md5(appSecret+userid + seller+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 + userid + seller + Config.AppSecret);
说明:Config.AppSecret为平台分配给开发者的密钥。