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

2023-11-21 16:20
文章标签 总结 事件 授权 消息 第三方 通知 程序开发 抖音 开放平台 代小

本文主要是介绍抖音开放平台第三方代小程序开发，授权事件、消息与事件通知总结，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

大家好，我是小悟

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

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

授权事件推送通知

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

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

Event的值为PUSH

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

授权成功：Event的值为AUTHORIZED

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

授权解除：Event的值为UNAUTHORIZED

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

授权码找回：
Event的值为UPDATE_AUTHORIZED

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

出于安全考虑，开放平台服务端会向第三方小程序后端服务推送加密后的消息，因此，服务商需要用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");}
}

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

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

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

修改服务类目：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": ""}]
}

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

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

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

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

版本审核结果：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"}]}]
}

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

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

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

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

获取用户手机号能力申请审核结果：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"}
}

分享模板审核结果：
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\"]"}
}

短视频/直播自主挂载能力审核结果通知：
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"}
}

短视频/直播自主挂载能力抖音号绑定结果通知：
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}
}

短视频达人推广挂载能力审核结果通知：
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"}
}

直播达人推广挂载能力审核结果通知：
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"}
}

出于安全考虑，开放平台服务端会向第三方小程序后端服务推送加密后的消息，因此，服务商需要用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");}
}

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

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

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

这篇关于抖音开放平台第三方代小程序开发，授权事件、消息与事件通知总结的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/403502。

相关文章

在Java中实现线程之间的数据共享的几种方式总结

在Java中实现线程之间的数据共享的几种方式总结

《在Java中实现线程之间的数据共享的几种方式总结》在Java中实现线程间数据共享是并发编程的核心需求,但需要谨慎处理同步问题以避免竞态条件,本文通过代码示例给大家介绍了几种主要实现方式及其最佳实践,... 目录1. 共享变量与同步机制2. 轻量级通信机制3. 线程安全容器4. 线程局部变量（ThreadL
阅读更多...
Go语言并发之通知退出机制的实现

Go语言并发之通知退出机制的实现

《Go语言并发之通知退出机制的实现》本文主要介绍了Go语言并发之通知退出机制的实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧... 目录1、通知退出机制1.1 进程/main函数退出1.2 通过channel退出1.3 通过cont
阅读更多...
Spring Boot 与微服务入门实战详细总结

Spring Boot 与微服务入门实战详细总结

《SpringBoot与微服务入门实战详细总结》本文讲解SpringBoot框架的核心特性如快速构建、自动配置、零XML与微服务架构的定义、演进及优缺点,涵盖开发环境准备和HelloWorld实战... 目录一、Spring Boot 核心概述二、微服务架构详解1. 微服务的定义与演进2. 微服务的优缺点三
阅读更多...
RabbitMQ消息总线方式刷新配置服务全过程

RabbitMQ消息总线方式刷新配置服务全过程

《RabbitMQ消息总线方式刷新配置服务全过程》SpringCloudBus通过消息总线与MQ实现微服务配置统一刷新,结合GitWebhooks自动触发更新,避免手动重启,提升效率与可靠性,适用于配... 目录前言介绍环境准备代码示例测试验证总结前言介绍在微服务架构中，为了更方便的向微服务实例广播消息，
阅读更多...
Java通过驱动包(jar包)连接MySQL数据库的步骤总结及验证方式

Java通过驱动包(jar包)连接MySQL数据库的步骤总结及验证方式

《Java通过驱动包(jar包)连接MySQL数据库的步骤总结及验证方式》本文详细介绍如何使用Java通过JDBC连接MySQL数据库,包括下载驱动、配置Eclipse环境、检测数据库连接等关键步骤,... 目录一、下载驱动包二、放jar包三、检测数据库连接JavaJava 如何使用 JDBC 连接 mys
阅读更多...
JavaSE正则表达式用法总结大全

JavaSE正则表达式用法总结大全

《JavaSE正则表达式用法总结大全》正则表达式就是由一些特定的字符组成,代表的是一个规则,：本文主要介绍JavaSE正则表达式用法的相关资料,文中通过代码介绍的非常详细,需要的朋友可以参考下... 目录常用的正则表达式匹配符正则表China编程达式常用的类Pattern类Matcher类PatternSynta
阅读更多...
java向微信服务号发送消息的完整步骤实例

java向微信服务号发送消息的完整步骤实例

《java向微信服务号发送消息的完整步骤实例》：本文主要介绍java向微信服务号发送消息的相关资料,包括申请测试号获取appID/appsecret、关注公众号获取openID、配置消息模板及代码... 目录步骤1. 申请测试系统2. 公众号账号信息3. 关注测试号二维码4. 消息模板接口5. Java测试
阅读更多...
MySQL 用户创建与授权最佳实践

MySQL 用户创建与授权最佳实践

《MySQL用户创建与授权最佳实践》在MySQL中,用户管理和权限控制是数据库安全的重要组成部分,下面详细介绍如何在MySQL中创建用户并授予适当的权限,感兴趣的朋友跟随小编一起看看吧... 目录mysql 用户创建与授权详解一、MySQL用户管理基础1. 用户账户组成2. 查看现有用户二、创建用户1. 基
阅读更多...
SQL中JOIN操作的条件使用总结与实践

SQL中JOIN操作的条件使用总结与实践

《SQL中JOIN操作的条件使用总结与实践》在SQL查询中,JOIN操作是多表关联的核心工具,本文将从原理,场景和最佳实践三个方面总结JOIN条件的使用规则,希望可以帮助开发者精准控制查询逻辑... 目录一、ON与WHERE的本质区别二、场景化条件使用规则三、最佳实践建议1.优先使用ON条件2.WHERE用
阅读更多...
Nginx Location映射规则总结归纳与最佳实践

Nginx Location映射规则总结归纳与最佳实践

《NginxLocation映射规则总结归纳与最佳实践》Nginx的location指令是配置请求路由的核心机制,其匹配规则直接影响请求的处理流程,下面给大家介绍NginxLocation映射规则... 目录一、Location匹配规则与优先级1. 匹配模式2. 优先级顺序3. 匹配示例二、Proxy_pa
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2