# 频道回调功能(弃用)

> 该功能非SaaS后台功能 直播间信息修改回调 对应文档。该回调没有后台配置页面，建议不使用该功能完成业务。

SaaS后台功能【直播间信息修改回调】对应文档：[频道改变回调通知](https://git.polyv.net/help-center/document-center/-/blob/master/live/api/uncategorized/callback/channel_change_callback/README.md)

### 作用

账号下直播频道新增、删除、修改（包括基本信息设置、讲师设置、嘉宾设置、直播状态的修改），会对所设置的接口地址进行回调通知。

### 详情

[设置回调接口地址后](https://git.polyv.net/help-center/document-center/-/blob/master/unclassified/2021/f1159f22be7273e34b534b8f459ca715/README.md)，当存在频道新增、修改、删除操作，会以post的方式请求回调接口

### 超时重试

回调服务器在发送消息通知后，5秒内没有收到您的服务器的响应，即认为通知失败。后续失败会以5秒、10秒、20秒的间隔继续重试3次。

### 回调消息格式

事件回调消息以 HTTP/HTTPS POST 请求发送给您的服务器，其中：

* 字符编码格式：UTF-8。
* 请求：body 格式为 JSON。url会带上timestamp和sign，验签名方式为md5(body + timestamp + appSecret)
* 应答要求：响应头需指定Content-Type: application/json；
* 正确应答：http status code: 200为正确业务接收处理，其他状态一律视为失败重试处理 。

### 回调数据示例

一、下述为“频道创建”的示例 ur参数：timestamp=1620878344475\&sign=eb7d6b79d3816214131015973294b179 响应体：

```json
{
    "channelId": 2290918,
    "channelName": "演示频道",
    "eventType": "ADD",
    "eventTime": "2021-05-13 11:58:29"
}
```

二、下述为“频道修改”的示例 ur参数：timestamp=1620878679926\&sign=176230a93b89023a974976eafda7c12a 响应体：

```json
{
    "channelId": 2290918,
    "channelName": "演示频道",
    "liveStatus": "waiting",
    "eventType": "MODIFY",
    "eventTime": "2021-05-13 12:04:04",
	"startTime": "2021-05-13 22:04:04",
	"splashImg":"https://liveimages.videocc.net/uploaded/images/2021/05/fyjxijew0x1.jpg"
    "publisher": "主持人",
    "teacher": {
        "nickname": "讲师",
        "actor": "讲师"
    },
    "guests": [
        {
            "nickname": "陈老师",
            "actor": "嘉宾"
        }
    ]
}
```

三、下述为“频道删除”的示例 ur参数：timestamp=1620878775840\&sign=2e4867bc2a6df0f648ed7ba43a63421c 响应体：

```json
{
    "channelId": 2290918,
    "channelName": "演示频道",
    "eventType": "DELETE",
    "eventTime": "2021-05-13 12:05:40"
}
```

### 回调参数说明

| 参数名                | 类型及范围  | 说明                                            |
| ------------------ | ------ | --------------------------------------------- |
| channelId          | int    | 频道id                                          |
| channelName        | string | 频道名称                                          |
| liveStatus         | string | 直播状态（live-直播，end-结束 waiting-等待直播，playback-回放） |
| eventType          | string | 事件类型（ADD-新增，MODIFY-修改，DELETE-删除）              |
| eventTime          | string | 事件触发时间                                        |
| publisher          | string | 主持人                                           |
| splashImg          | string | 引导页图片                                         |
| startTime          | string | 开播时间                                          |
| teacher            | object | 主持                                            |
| teacher.nickname   | string | 主持昵称                                          |
| teacher.actor      | string | 主持头衔                                          |
| guests             | array  | 嘉宾                                            |
| guests\[].nickname | string | 嘉宾昵称                                          |
| guests\[].actor    | string | 嘉宾头衔                                          |
