微吼开放平台
平台概述
开发者文档
开发者文档
  • 嵌入指南
  • SDK文档
  • 服务端API
产品功能
产品功能
  • 新手入门
  • 功能介绍
  • 常见问题
微吼官网
平台概述
开发者文档
开发者文档
  • 嵌入指南
  • SDK文档
  • 服务端API
产品功能
产品功能
  • 新手入门
  • 功能介绍
  • 常见问题
微吼官网
  1. 发起页 iframe 嵌入
  • 控制台 iframe 嵌入
    • 产品介绍
    • 嵌入示例
    • 嵌入说明
    • 控制台 iframe 嵌入事件通信
  • 发起页 iframe 嵌入
    • 完整发起页 iframe 嵌入
    • 单视频发起页 iframe 嵌入
    • 发起页 iframe 嵌入事件通信
  • 观看页 iframe 嵌入
    • 产品介绍
    • 嵌入说明
    • 嵌入示例
    • 嵌入页商品支付说明
    • 三方K值验证流程说明
    • 观看页 iframe 嵌入事件通信
  1. 发起页 iframe 嵌入

发起页 iframe 嵌入事件通信

背景#

本文档用于三方站点嵌入我司页面场景,双方通过 window.postMessage 进行跨页面消息通信。
我司页面触发业务动作后,主动向外抛出对应事件,贵司可监听消息事件,按需处理自身业务逻辑。

通信规则#

1、通信方式:浏览器原生 window.postMessage
2、监听方式:页面监听 message 事件接收消息
3、消息结构统一格式
{
  "type": "事件标识字符串",
  "data": {}
}

现有业务事件列表#

抽奖-中奖名单导出完成
事件标识 : lottery_winners_export_success
触发时机 : 导出抽奖中奖名单
消息示例
{
    "type": "lottery_winners_export_success",
    "data": {
        "id": 1773438,
        "webinar_id": 589130988
    }
}
层级字段类型说明
根级typestring事件类型
根级dataobject业务参数集合
data ->idinteger抽奖 ID
data ->webinar_idinteger活动 ID
快问快答-答题成绩排名导出完成
事件标识 : exam_rank_export_success
触发时机 : 导出快问快答答题成绩排名
消息示例
{
    "type": "exam_rank_export_success",
    "data": {
        "paper_id": 54257,
        "webinar_id": 589130988
    }
}
层级字段类型说明
根级typestring事件类型
根级dataobject业务参数集合
data ->paper_idinteger试卷ID
data ->webinar_idinteger活动ID
商城奖励-中奖名单导出完成
事件标识 : mall_rewards_export_success
触发时机 : 导出商城奖励中奖名单
消息示例
{
    "type": "mall_rewards_export_success",
    "data": {
        "reward_id": 1038,
        "webinar_id": 589130988
    }
}
层级字段类型说明
根级typestring事件类型
根级dataobject业务参数集合
data ->reward_idinteger商城奖励ID
data ->webinar_idinteger活动ID

注意事项#

建议对接方增加来源域名校验,保障通信安全

代码示例#

修改于 2026-05-25 09:29:45
上一页
单视频发起页 iframe 嵌入
下一页
产品介绍
Built with