回调事件说明

在直播过程中，状态变更和回放转码等事件可能影响客户的业务系统展示和动作。为了将这些关键事件变更通知客户，微吼直播提供了主动的消息推送服务。当事件触发时，微吼会调用客户配置的回调事件接口进行通知，以便客户进行相应的动态更新。

注意事项

在使用回调服务前，请确保已设置回调事件。您可以通过 API 接口或在 控制台 > 设置中心 > 开发设置 > 回调设置 完成配置。当事件触发时，接口会通过 HTTP POST 方式将状态变化发送到您的服务器。

如若服务器存在安全策略限制，禁止访问，请将微吼回调服务的出口 IP 设置为允许访问的白名单。

回调服务出口 IP：

82.156.84.44
82.156.44.216
82.156.103.174
82.156.121.115

消息组织格式

通知信息通过 HTTP POST 方式发送，支持以下两种 Content-Type 消息格式：

application/x-www-form-urlencoded（默认）

application/json

消息失败重试机制

系统默认发送一次通知。如需在消息接受失败后重新发送，请开启失败重试开关。开启后，业务系统需在接收到消息后5秒内返回 success（不区分大小写），以视为通知成功，否则将按以下间隔重试：

10 秒

30 秒

1 分钟～10 分钟

20 分钟

30 分钟

1 分钟

2 小时

注意：消息中的 mid 属性是唯一标识，业务系统需确保幂等性处理。

签名方法

API 签名用于系统交互，以确保请求数据的准确性和接口的安全性。

特别注意：

在微吼主动推送数据到对接系统的场景中，微吼会对推送的数据进行签名。对接系统应使用相同的签名机制来验证签名无误，然后再进行业务处理。

处理中待签名字符串时，所有返回的参数键值对（kv）都需按照规则处理。切勿使用固定字段的顺序进行字符串拼装，因为微吼可能在后续系统升级中增加返回参数。这可能导致签名验证失败。因此，在进行回调对接时，请避免依赖固定字段顺序，应依据动态的参数处理方式，以确保签名验证的正确性和兼容性。

签名中如遇到接口参数有数组或字典字段 ,（如key=>[1,2,3]）或字典（如key=>{"id": 123}），仅保留键名（即key=后的值不参与拼接）

**签名步骤 : **

参数准备

从本次请求中提取所有参与签名的参数（包括 Body 及 Query 中的字段），并在提取时剔除 signature字段本身（该字段仅用于验签，不参与签名计算）。

注意：对所有参数名与参数值去除首尾空格，以保证拼接结果的一致性。

注意：须动态获取上述处理后的参数列表，禁止硬编码参数名或固定顺序，以防我方后续新增参数导致验签失败。

参数排序

将处理后的参数按键名的 ASCII 码升序排列（不含 signature参数），排序后进行字符串拼接与签名计算。

密钥处理

需对贵司提供的secret_key进行MD5加密（从而生成固定长度的加密字符串）

字符串拼接

对每个排序后的参数按固定格式拼接：

参数名|md5_secret_key|参数值

非复合类型（字符串、数字等）：直接拼接参数值

复合类型（数组 List、字典 Map）：仅拼接参数名|md5_secret_key|（跳过参数值）

生成签名

对拼接完成的字符串进行 MD5 加密，生成最终签名

Java签名方法示例

Java签名方法DEMO

下载地址 : https://gitee.com/vhall/vop-callback-demo

注意事项#

消息组织格式#

消息失败重试机制#

签名方法#

Java签名方法示例#

Java签名方法DEMO#

注意事项

消息组织格式

消息失败重试机制

签名方法

Java签名方法示例

Java签名方法DEMO