房间创建回调
描述
当开发者需要了解某个房间创建的相关信息时,可以通过本回调获取。
回调说明
- 请求方法:POST。
说明
回调数据格式为 JSON,您需要对其进行 UrlDecode 解码。
- 请求地址:请在 ZEGO 控制台 上配置回调地址。
- 传输协议:HTTPS/HTTP,建议使用 HTTPS。
回调参数
公共参数 | 类型 | 描述 |
---|---|---|
event | String | 回调事件,此回调返回值为 room_create 。 |
appid | UInt32 | APP 的唯一标识。 |
timestamp | Int64 | 服务器当前时间,Unix 时间戳,单位:秒。 |
nonce | String | 随机数。 |
signature | String | 检验串,详情见 检验说明。 |
业务参数 | 类型 | 描述 |
room_id | String | 房间 ID。 |
room_session_id | UInt64 | 房间生命周期唯一标识,在该房间的整个生命周期中保持不变。 |
room_create_time | String | 房间创建时间,服务器当前时间,Unix 时间戳,单位:毫秒。 |
id_name | String | 房间创建者的用户 ID。 |
说明
建议您将部分参数转换为 Int 进行逻辑处理,相关字段包括 room_create_time
。
数据示例
{
"event": "room_create",
"appid": 1,
"timestamp": 1499676978,
"nonce": "350176",
"signature": "signature",
"room_id": "rid_1242649",
"room_session_id": 858012925204410400,
"room_create_time": "1499676978027",
"id_name": "id123"
}
返回响应
返回 HTTP status code 为 2XX (例如 200)表示成功,其他响应都表示失败。
回调重试策略
如果 ZEGO 服务器没有收到响应,或收到的 HTTP status code 不为 2XX(例如 200),都会尝试重试,最多进行 5 次重试。每次重试请求与上一次请求的间隔时间分别为 2s、4s、8s、16s、32s。若第 5 次重试后仍然失败,将不再重试,该回调丢失。