商家店铺授权给开发者
当开发者获取商家的店铺订单时，商家需要授权给开发者。授权有2种方式, 分别是授权链接和授权码方式. 由于抖店本身的机制, 对于新订购的用户(首次授权时,会丢失state参数,不能跳回授权回调地址), 如果对这方面有要求的场景,可以通过授权码方式完成授权.
开发者提供授权链接，让商家点击跳去授权 。
抖店服务市场订购:
1. 千里马打单 https://fuwu.jinritemai.com/detail?service_id=23042
2. 千里马ERP https://fuwu.jinritemai.com/detail?service_id=22061
一.通过授权链接完成授权
开发者可在自己的网站添加授权入口，让商家点击下面的授权链接，商家使用自己的抖店账号登录后，再进行授权，授权完成后，蜂巢开放平台会回调开发者的网站，并将授权的商家账号及订购时间传回。
授权链接格式为：
https://kf.fw199.com/partner/ddomsgrant?appid=Your_AppId&callback=Your_CallBackUrl&sysid=SYSID
上述拼接授权URL相关参数说明：
| 参数名称 | 是否必选 | 参数说明 | 示例 |
|---|---|---|---|
| appid | 必选 | 开发者AppId | 38lsDeiaqpjpLsAA ，请改为开发者自己的AppId |
| callback | 可选 | 开发者的回调url ， url应以http或https开头，回调url可以附带开发者的自定义参数（回调时会原样返回），商家授权完成后，蜂巢系统会将页面重定向到此url, 此url需要进行UrlEncode | |
| sysid | 可选 | 应用标识，200：千里马打单 , 201: 千里马ERP。 不传入默认200， | 200 |
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，并同时附上doudianseller、doudianuserid 参数，参数需要urlDecode。
调回url类似如下 ：
回调参数说明
| 参数名称 | 参数说明 | 示例 |
|---|---|---|
| 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会包含失败原因。
