【团购核销】抖音生活服务商家应用快速接入②——商家授权

一、前言

目的：将抖音团购核销的功能集成到我们自己开发的App和小程序中

• 【团购核销】抖音生活服务商家应用快速接入①——基础工作
• 【团购核销】抖音生活服务商家应用快速接入②——商家授权
• 【团购核销】抖音生活服务商家应用快速接入③——团购核销验券

二、授权流程

• 以杆知乐（24小时自助台球棋牌）为例。

三、授权Url

• 业务授权URL：https://auth.dylk.com/auth-isv/

https://auth.dylk.com/auth-isv/?client_key=awxxxxxxxx&timestamp=1677686399&sign=xxxxxxxxxxxxxx&solution_key=1&permission_keys=1,16&out_shop_id=shop_id&charset=UTF-8&extra=aaaaaaaaaa

3.1 Url参数表

字段	含义	必填
client_key	服务商应用标示	是
timestamp	url开始生效的秒时间戳 ​，24小时内有效	是
solution_key	到店餐饮1，到店团购2，随心团5	是
permission_keys​	授权能力如2.2表	是
charset	交互数据的编码 固定值:UTF-8​	是
sign	根据参数内容生成的签名	是
client_key	服务商应用标示	是
out_shop_id	绑定抖音门店的外部门店ID	否

3.2 授权能力表

​能力枚举permission_keys​	语义​
​1 ​	​门店管理​
2	​订单查询​
3	​门店基础信息更新​
4 ​	​门店任务查询​
​5 ​	​同步门店户​
​6 ​	​门店匹配​
​7 ​	​门店装修​
​8 ​	​门店亮照​
​9 ​	​会员管理​
​10 ​	​商品查询​
​11 ​	​商品发布​
​12 ​	​团购核销​
​13 ​	​cps佣金设置与查询​
​14 ​	​KA核销对账​
​15 ​	​团购核销对账​
​16 ​	​商户授权​
​17 ​	​三方码发布​
18 ​​	同步品牌户​
​19​	​客资查询​

3.3 源码示例

• 快速生成商家授权链接

private final static String AuthUrl = "https://auth.dylk.com/auth-isv/";public static String genAuthWithBindValidUrlFast(String outShopId) {Map<String, String> query = new HashMap<>();query.put("client_key", APPID);query.put("timestamp", String.valueOf(System.currentTimeMillis() / 1000));query.put("charset", "UTF-8");query.put("solution_key", "4");query.put("out_shop_id", outShopId);query.put("permission_keys", "1,2,10,12,14,15,16");String signResult = SignUtil.signV2(AppSecret, "", query);query.put("sign", signResult);String queryStr = query.entrySet().stream().map(entry -> new StringBuilder().append(entry.getKey()).append("=").append(entry.getValue())).collect(Collectors.joining("&"));StringBuilder resultSb = new StringBuilder(AuthUrl).append("?").append(queryStr);return resultSb.toString();
}

• 签名加密SignUtil.java

/*** SignV2 用于生活服务应用计算header中的签名(sha256) 新申请应用请使用该方法计算* @param clientSecret 应用secret* @param body post请求/spi请求中的body参数json字符串* @param query url参数* @return 签名*/
public static String signV2(String clientSecret, String body, Map<String, String> query) {StringBuilder str = new StringBuilder(clientSecret);query.keySet().stream().filter(a -> !"sign".equals(a)).sorted().forEach(k -> {String val = query.get(k);str.append("&");str.append(k).append("=").append(val);});if (body != null && !"".equals(body)) {str.append("&");str.append("body").append("=").append(body);}System.out.printf("[Sign] v2 str:%s\n", str.toString());String result = SHA256(str.toString());System.out.printf("[Sign] v2 str:%s, result:%s\n", str.toString(), result);return result;
}/*** SHA-256加密* @param input 明文* @return 密文*/
public static String SHA256(String input) {String result = "";try {MessageDigest md = MessageDigest.getInstance("SHA-256");md.update(input.getBytes(StandardCharsets.UTF_8));byte[] digest = md.digest();result = bytes2Hex(digest);} catch (NoSuchAlgorithmException e) {e.printStackTrace();}return result;
}

四、授权回调

4.1 添加授权回调接口

• 抖音开放平台（服务商平台）
• 第三方生活服务商家应用
• 开发设置
• Webhooks
• 添加你写好的接口，如果你的接口没写好，则会提示参数不合法

• 如果接口是ok的，则会提示添加成功。
  

4.2 授权回调接口源码示例

1. 校验签名，加密请求体与请求体的签名进行对比
2. 判断是key和event无误
3. 则保存商户授权信息

/*** 抖音推送接口*/
@PostMapping("/douyin/messages")
public String douyinMessage(@RequestBody String body, @RequestHeader Map<String, String> headers)
{log.info(body);log.info(headers.toString());// 获取请求头中的加签信息String douyinSign = headers.get("X-Douyin-Signature");if(douyinSign==null || douyinSign.length()==0){douyinSign = headers.get("x-douyin-signature");}String data = DouYinUtils.AppSecret + body;String sign = DigestUtils.sha1Hex(data);if(!sign.equals(douyinSign)){log.error("验签失败, data="+data);log.error("验签失败, sign1="+sign);log.error("验签失败, sign2="+douyinSign);return AjaxResult.error().toString();}JSONObject douyinData = JSONObject.parseObject(body);if(douyinData.getString("client_key").equals(DouYinUtils.APPID)){if(douyinData.getString("event").equals("life_saas_cooperate_auth_with_bind")){String content = douyinData.getString("content");JSONObject jsonObject = JSONObject.parseObject(content);Long shopId = Long.valueOf(jsonObject.getString("out_shop_id"));String accountId = jsonObject.getString("account_id");String solutionKey = jsonObject.getString("solution_key");String permissionKey = jsonObject.getJSONArray("permission_keys").toJSONString();BilliardsDouyin billiardsDouyin = new BilliardsDouyin();billiardsDouyin.setAccountId(accountId);billiardsDouyin.setPermissionKeys(permissionKey);billiardsDouyin.setSolutionKey(solutionKey);billiardsDouyin.setShopId(shopId);log.info(billiardsDouyin.toString());billiardsDouyinService.insertBilliardsDouyin(billiardsDouyin);BilliardsShop billiardsShop = billiardsShopService.selectBilliardsShopById(shopId);if (ObjectUtil.isNull(billiardsShop)) {log.error("抖音商家授权回调接口，查无此球厅");return AjaxResult.error().toString();}billiardsShop.setDouyinId(accountId);billiardsShopService.updateBilliardsShop(billiardsShop);}}return douyinData.getJSONObject("content").toJSONString();
}

五、实际操作演示

六、参考

• 能力授权&门店绑定SDK_生活服务商家应用_抖音开放平台
• 生活服务消息推送_生活服务商家应用_抖音开放平台

觉得好，就一键三连呗（点赞+收藏+关注）