• 抖音开放平台第三方代小程序开发，授权事件、消息与事件通知总结

    大家好，我是小悟

    关于抖音开放平台第三方代小程序开发的两个事件接收推送通知，是开放平台代小程序实现业务的重要功能。

    授权事件推送和消息与事件推送类型都以Event的值判断。

    授权事件推送通知

    在这里插入图片描述
    授权事件推送包括：推送票据、授权成功、授权解除、授权码找回。抖音服务器会向第三方平台方的授权事件接收 URL 以 POST 的方式推送相关通知。

    推送票据：在第三方平台创建审核通过后，抖音服务器会向其“授权事件接收URL” 每隔10分钟以 POST 的方式推送票据。

    Event的值为PUSH

    {
  "Ticket": "8c0da4968b0d1e28acbc1d738a56607d",
  "FromUserName": "ByteDanceMicroApp",
  "CreateTime": "2019-01-14 12:45:10",
  "MsgType": "Ticket",
  "Event": "PUSH"
}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7

    授权成功：Event的值为AUTHORIZED

    {
  "AppId": "授权小程序的appid",
  "TpAppId": "第三方小程序应用appid",
  "EventTime": "2019-01-14 12:45:10",
  "Event": "AUTHORIZED",
  "AuthorizationCode": "授权码",
  "AuthorizationCodeExpiresIn": 3600，
  "AppName": "代创建的小程序名称",
  "AppIcon": "代创建的小程序图标",
  "CompanyName": "代创建的小程序公司主体名称",
  "AppSuperAdminEmail": "代创建的小程序超管掩码邮箱",
  "AppSuperAdminMobile": "代创建的小程序超管掩码手机号"
}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13

    授权解除：Event的值为UNAUTHORIZED

    {
  "AppId": "授权小程序的appid",
  "TpAppId": "第三方小程序应用appid",
  "EventTime": "2019-01-14 12:45:10",
  "Event": "UNAUTHORIZED"
}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6

    授权码找回：
    Event的值为UPDATE_AUTHORIZED

    {
  "AppId": "授权小程序的appid",
  "TpAppId": "第三方小程序应用appid",
  "EventTime": "2019-01-14 12:45:10",
  "Event": "UPDATE_AUTHORIZED",
  "AuthorizationCode": "授权码",
  "AuthorizationCodeExpiresIn": 3600
}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8

    出于安全考虑，开放平台服务端会向第三方小程序后端服务推送加密后的消息，因此，服务商需要用key解密后才能查看具体信息。另外推送消息格式均为 json，并且第三方小程序后端服务接收到后需要响应并返回字符串 success。

    @PostMapping(value = "authPushMsg")
public void authPushMsg(PostDataModel postData) throws IOException {
    BufferedReader br = new BufferedReader(new InputStreamReader(request.getInputStream(),"UTF-8"));
    StringBuffer sb = new StringBuffer();
    String line;
    while ((line = br.readLine()) != null) {
      sb = sb.append(line);
    }
    String postStr = sb.toString();
    logger.warn("授权推送消息---->获得数据为postData={}", postStr);
    PostDataModel postData = JSON.parseObject(postStr, PostDataModel.class);
    try {
      logger.warn("授权推送消息，开始");
      ServerVerification serverVerification = new ServerVerification();
      String msgSignature = serverVerification.getMsgSignature(thirdPlatConfig.getMsgCheckToken(), postData.getTimeStamp(), postData.getNonce(), postData.getEncrypt());
      if (StringUtils.equals(postData.getMsgSignature(), msgSignature)) {
        MsgDecrypt msgDecrypt = new MsgDecrypt(thirdPlatConfig.getMsgEncodingAesKey());
        String decrypt = msgDecrypt.decrypt(postData.getEncrypt());
        logger.warn("授权推送消息，解密结果={}", decrypt);
        if (decrypt.contains("Ticket") && decrypt.contains("PUSH")) {
          logger.warn("推送ticket协议---->开始");
          // 推送ticket通知
          ComponentVerifyTicket componentVerifyTicket = JSON.parseObject(decrypt, ComponentVerifyTicket.class);
          componentVerifyTicket.setComponentVerifyTicket(componentVerifyTicket.getTicket());
          RedisService<ComponentVerifyTicket> redisService = RedisService.load();
          redisService.save(componentVerifyTicket, ComponentVerifyTicket.class);
          logger.warn("推送ticket协议---->成功，保存到缓存中的值为：{}", JSON.toJSONString(componentVerifyTicket));
        } else {
          // 授权成功、授权解除、授权码找回
          AuthPushAuthorized authPushAuthorized = JSON.parseObject(decrypt, AuthPushAuthorized.class);
          String event = authPushAuthorized.getEvent();
          if (StringUtils.equals(EventEnum.AUTHORIZED.getCode(), event)) {
            logger.warn("推送授权成功通知---->成功，{}", JSON.toJSONString(authPushAuthorized));
          } else if (StringUtils.equals(EventEnum.UNAUTHORIZED.getCode(), event)) {
            logger.warn("推送授权解除通知---->成功，{}", JSON.toJSONString(authPushAuthorized));
          } else if (StringUtils.equals(EventEnum.UPDATE_AUTHORIZED.getCode(), event)) {
            logger.warn("推送授权码找回通知---->成功，{}", JSON.toJSONString(authPushAuthorized));
          }
        }
      }
    } catch (Exception e) {
      logger.error("系统异常", e);
    } finally {
      // 响应消息
      PrintWriter out = response.getWriter();
      out.print("success");
    }
}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25
    • 26
    • 27
    • 28
    • 29
    • 30
    • 31
    • 32
    • 33
    • 34
    • 35
    • 36
    • 37
    • 38
    • 39
    • 40
    • 41
    • 42
    • 43
    • 44
    • 45
    • 46
    • 47
    • 48

    消息与事件推送通知
    在这里插入图片描述
    消息与事件推送包括：修改小程序名称、小程序名称重置、修改服务类目、修改小程序简介、修改小程序图标、版本审核结果、短视频挂载能力申请审核结果、抖音直播组件能力申请审核结果、获取用户手机号能力申请审核结果、分享模板审核结果、短视频/直播自主挂载能力审核结果通知、短视频/直播自主挂载能力抖音号绑定结果通知、短视频达人推广挂载能力审核结果通知、直播达人推广挂载能力审核结果通知。审核结果会向消息与事件接收 URL 进行事件推送。

    修改小程序名称：
    Event的值为MODIFY_APP_NAME

    {
  "AppId": "授权小程序的appid",
  "TpAppId": "第三方小程序应用appid",
  "EventTime": "2019-01-14 12:45:10",
  "Event": "MODIFY_APP_NAME",
  "ModifyAppNameResults": {
    "advice": "",
    "reason": "小程序名称格式不符合规范",
    "status": 0
  }
}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11

    小程序名称重置：Event的值为
    APP_NAME_RESET_NOTIFICATION

    {
  "AppId": "授权小程序的appid",
  "TpAppId": "第三方小程序应用appid",
  "EventTime": "2019-01-14 12:45:10",
  "Event": "APP_NAME_RESET_NOTIFICATION",
  "AppNameResetNotification": "您好，您管理的小程序「%s」由于长时间未提交版本审核，名称已经被重置为「名称过期%s」。如需修改，请前往配置页面重新填写名称。"
}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7

    修改服务类目：Event的值为
    MODIFY_APP_CATEGORY

    {
    "AppId": "授权小程序的appid",
    "TpAppId": "第三方小程序应用appid",
    "EventTime": "2019-01-14 12:45:10",
    "Event": "MODIFY_APP_CATEGORY",
    "ModifyAppCategoryResults": [
        {
            "category": "158,159,259",
            "categoryName": "社交类-社交-直播",
            "status": 1,
            "reason": ""
        }
    ]
}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14

    修改小程序简介：
    Event的值为MODIFY_APP_INTRO

    {
  "AppId": "授权小程序的appid",
  "TpAppId": "第三方小程序应用appid",
  "EventTime": "2019-01-14 12:45:10",
  "Event": "MODIFY_APP_INTRO",
  "ModifyAppIntroResults": {
    "reason": "小程序简介格式不符合规范",
    "status": 0
  }
}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10

    修改小程序图标：
    Event的值为MODIFY_APP_ICON

    {
  "AppId": "授权小程序的appid",
  "TpAppId": "第三方小程序应用appid",
  "EventTime": "2019-01-14 12:45:10",
  "Event": "MODIFY_APP_ICON",
  "ModifyAppIconResults": {
    "reason": "小程序名称格式不符合规范",
    "status": 0
  }
}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10

    版本审核结果：Event的值为PACKAGE_AUDIT

    {
    "AppId": "授权小程序的appid",
    "TpAppId": "第三方小程序应用appid",
    "EventTime": "2019-01-14 12:45:10",
    "Event": "PACKAGE_AUDIT",
    "AuditResults": [
        {
            "hostName": "toutiao",
            "reason": ["", ""],
            "status": 1,
            "auditDetail": [
                {
                    "reason":"xxx",
                    "modifyGuide": {
                        "name":"xxx",
                        "link":"xxx"
                    },
                    "detailFile":"xxx"
                }
            ]
        }
    ]
}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23

    短视频挂载能力申请审核结果：Event的值为APPLY_VIDEO_CAPABILITY

    {
  "AppId": "授权小程序的appid",
  "TpAppId": "第三方小程序应用appid",
  "EventTime": "2019-01-14 12:45:10",
  "Event": "APPLY_VIDEO_CAPABILITY",
  "ApplyVideoCapabilityResults": {
    "status": 0,
    "reason": "xxx"
  }
}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10

    抖音直播组件能力申请审核结果：Event的值为APPLY_LIVE_CAPABILITY

    {
  "AppId": "授权小程序的appid",
  "TpAppId": "第三方小程序应用appid",
  "EventTime": "2019-01-14 12:45:10",
  "Event": "APPLY_LIVE_CAPABILITY",
  "ApplyLiveCapabilityResults": {
    "status": 0,
    "reason": "xxx"
  }
}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10

    获取用户手机号能力申请审核结果：Event的值为
    APPLY_PHONE_NUMBER_CAPABILITY

    {
  "AppId": "授权小程序的appid",
  "TpAppId": "第三方小程序应用appid",
  "EventTime": "2019-01-14 12:45:10",
  "Event": "APPLY_PHONE_NUMBER_CAPABILITY",
  "ApplyPhoneNumberCapabilityResults": {
    "status": 0,
    "reason": "xxx"
  }
}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10

    分享模板审核结果：
    Event的值为APPLY_SHARE_TEMPLATE

    {
  "AppId": "授权小程序的appid",
  "TpAppId": "第三方小程序应用appid",
  "EventTime": "2019-01-14 12:45:10",
  "Event": "APPLY_SHARE_TEMPLATE",
  "ApplyShareTemplateResults": {
    "templateId": "xxx",
    "status": 0,
    "reason": "[\"xxx\",\"xxx\"]"
  }
}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11

    短视频/直播自主挂载能力审核结果通知：
    Event的值为APPLY_CAPACITY，需要结合
    EventContent.capacity_key的值判断

    {
  "AppId": "授权小程序的appid",
  "TpAppId": "第三方小程序应用appid",
  "EventTime": "2019-01-14 12:45:10",
  "Event": "APPLY_CAPACITY",
  "EventContent": {
// 能力key，video_self_mount-短视频自主挂载；live_self_mount-直播自主挂载。
    "capacity_key": "能力key",
    "status": 1,
    "reason": "xxx"
  }
}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12

    短视频/直播自主挂载能力抖音号绑定结果通知：
    Event的值为SELT_MOUNT_BIND，需要结合
    EventContent.capacity_key的值判断

    {
  "AppId": "授权小程序的appid",
  "TpAppId": "第三方小程序应用appid",
  "EventTime": "2019-01-14 12:45:10",
  "Event": "SELT_MOUNT_BIND",
  "EventContent": {
// 能力key，video_self_mount-短视频自主挂载；live_self_mount-直播自主挂载。
    "capacity_key": "能力key",
    "aweme_id": "抖音号",
    "user_name": "抖音用户昵称",
    "bind_status": 1
  }
}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13

    短视频达人推广挂载能力审核结果通知：
    Event的值为APPLY_CAPACITY，需要结合
    EventContent.capacity_key的值判断

    {
  "AppId": "授权小程序的appid",
  "TpAppId": "第三方小程序应用appid",
  "EventTime": "2019-01-14 12:45:10",
  "Event": "APPLY_CAPACITY",
  "EventContent": {
// 能力key，video_talent_mount-短视频达人推广挂载能力。
    "capacity_key": "能力key",
    "status": 1,
    "reason": "xxx"
  }
}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12

    直播达人推广挂载能力审核结果通知：
    Event的值为APPLY_CAPACITY，需要结合
    EventContent.capacity_key的值判断

    {
  "AppId": "授权小程序的appid",
  "TpAppId": "第三方小程序应用appid",
  "EventTime": "2019-01-14 12:45:10",
  "Event": "APPLY_CAPACITY",
  "EventContent": {
// 能力key，ma.mount.live_talent_mountt-直播达人推广挂载能力。
    "capacity_key": "能力key",
    "status": 1,
    "reason": "xxx"
  }
}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12

    出于安全考虑，开放平台服务端会向第三方小程序后端服务推送加密后的消息，因此，服务商需要用key解密后才能查看具体信息。另外推送消息格式均为 json，并且第三方小程序后端服务接收到后需要响应并返回字符串 success。

    @PostMapping(value = "eventPushMsg")
public void eventPushMsg(PostDataModel postData) throws IOException {
    BufferedReader br = new BufferedReader(new InputStreamReader(request.getInputStream(),"UTF-8"));
    StringBuffer sb = new StringBuffer();
    String line;
    while ((line = br.readLine()) != null) {
      sb = sb.append(line);
    }
    String postStr = sb.toString();
    logger.warn("事件推送消息---->获得数据为postData={}", postStr);
    PostDataModel postData = JSON.parseObject(postStr, PostDataModel.class);
    try {
      logger.warn("事件推送消息，开始");
        ServerVerification serverVerification = new ServerVerification();
        String msgSignature = serverVerification.getMsgSignature(thirdPlatConfig.getMsgCheckToken(), postData.getTimeStamp(), postData.getNonce(), postData.getEncrypt());
        if (StringUtils.equals(postData.getMsgSignature(), msgSignature)) {
            MsgDecrypt msgDecrypt = new MsgDecrypt(thirdPlatConfig.getMsgEncodingAesKey());
            String decrypt = msgDecrypt.decrypt(postData.getEncrypt());
            logger.warn("事件推送消息，解密结果={}", decrypt);
            EventPushMsg eventPushMsg = JSON.parseObject(decrypt, EventPushMsg.class);
            String event = eventPushMsg.getEvent();
            if (StringUtils.equals(EventEnum.MODIFY_APP_NAME.getCode(), event)) {
                logger.warn("修改名称审核结果通知---->通知，{}", JSON.toJSONString(eventPushMsg));
            } else if (StringUtils.equals(EventEnum.APP_NAME_RESET_NOTIFICATION.getCode(), event)) {
                logger.warn("名称重置通知---->通知，{}", JSON.toJSONString(eventPushMsg));
            } else if (StringUtils.equals(EventEnum.MODIFY_APP_INTRO.getCode(), event)) {
                logger.warn("修改简介审核结果通知---->通知，{}", JSON.toJSONString(eventPushMsg));
            } else if (StringUtils.equals(EventEnum.MODIFY_APP_ICON.getCode(), event)) {
                logger.warn("修改图标审核结果通知---->通知，{}", JSON.toJSONString(eventPushMsg));
            } else if (StringUtils.equals(EventEnum.MODIFY_APP_CATEGORY.getCode(), event)) {
                logger.warn("修改服务类目审核结果通知---->通知，{}", JSON.toJSONString(eventPushMsg));
            } else if (StringUtils.equals(EventEnum.PACKAGE_AUDIT.getCode(), event)) {
                logger.warn("版本审核结果通知---->通知，{}", JSON.toJSONString(eventPushMsg));
            } else if (StringUtils.equals(EventEnum.APPLY_VIDEO_CAPABILITY.getCode(), event)) {
                logger.warn("「短视频挂载」能力申请审核结果通知---->通知，{}", JSON.toJSONString(eventPushMsg));
            } else if (StringUtils.equals(EventEnum.APPLY_LIVE_CAPABILITY.getCode(), event)) {
                logger.warn("「抖音直播组件」能力申请审核结果通知---->通知，{}", JSON.toJSONString(eventPushMsg));
            } else if (StringUtils.equals(EventEnum.APPLY_PHONE_NUMBER_CAPABILITY.getCode(), event)) {
                logger.warn("「获取用户手机号」能力申请审核结果通知---->通知，{}", JSON.toJSONString(eventPushMsg));
            } else if (StringUtils.equals(EventEnum.APPLY_CAPACITY.getCode(), event)) {
                logger.warn("短视频/直播自主挂载能力审核结果通知---->通知，{}", JSON.toJSONString(eventPushMsg));
                logger.warn("短视频达人推广挂载能力审核结果通知---->通知，{}", JSON.toJSONString(eventPushMsg));
                logger.warn("直播达人推广挂载能力审核结果通知---->通知，{}", JSON.toJSONString(eventPushMsg));
            } else if (StringUtils.equals(EventEnum.SELT_MOUNT_BIND.getCode(), event)) {
                logger.warn("短视频/直播自主挂载能力抖音号绑定结果通知---->通知，{}", JSON.toJSONString(eventPushMsg));
            }
        }
      }
    } catch (Exception e) {
      logger.error("系统异常", e);
    } finally {
      // 响应消息
      PrintWriter out = response.getWriter();
      out.print("success");
    }
}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25
    • 26
    • 27
    • 28
    • 29
    • 30
    • 31
    • 32
    • 33
    • 34
    • 35
    • 36
    • 37
    • 38
    • 39
    • 40
    • 41
    • 42
    • 43
    • 44
    • 45
    • 46
    • 47
    • 48
    • 49
    • 50
    • 51
    • 52
    • 53
    • 54
    • 55
    • 56

    您的一键三连，是我更新的最大动力，谢谢

    山水有相逢，来日皆可期，谢谢阅读，我们再会

    我手中的金箍棒，上能通天，下能探海

  • 相关阅读:
    awk,gawk,mawk,nawk的重定向笔记221107
    Leetcode 105. Construct Binary Tree from Preorder and Inorder Traversal
    CS5266BN说明书|CS5266BN QFN48封装规格书|CS5266BN设计资料
    Leetcode 刷题日记 剑指 Offer II 055. 二叉搜索树迭代器
    java面向对象(三)
    接口测试经典面试题：Session、cookie、token有什么区别？
    一条来自水圈的鄙视链
    动态规划的算法题以及其python实现
    汽车电子相关术语
    基于深度学习的活体人脸识别检测算法matlab仿真
  • 原文地址：https://blog.csdn.net/LiuAustin/article/details/133841061