延长信令房间的有效期

更新时间: 2025/08/19 15:37:22

该接口支持延长信令频道的有效期。

信令频道房间创建后,默认的有效时间为 2 小时。若需要延长有效期,可以调用本接口,调用成功后,有效期将会在当前时间往后延长 2 小时。

调用频率

单个应用默认最高调用频率请参考 频控说明

请求信息

请求 URL

httpsPOST https://api.yunxinapi.com/nimserver/signal/delayRoom.action  HTTP/1.1
Content-Type: application/x-www-form-urlencoded;charset=utf-8

请求头参数

请求 Header 的参数说明请参考 请求 Header

请求体参数

参数名称 类型 是否必选 描述
channelId String 信令频道 ID。

请求示例

curlcurl -X POST -H "AppKey: go9dnk49***w0803mgq3" -H "Nonce: 4tggge**23t23t" -H "CurTime: 1443592222" -H "CheckSum: 9e9db3b6c9abb**cc55583f86" -H "Content-Type: application/x-www-form-urlencoded" -d 'channelId=ch_87654321' 'https://api.yunxinapi.com/nimserver/signal/delayRoom.action'

响应示例

响应头参数

响应 Header 的参数说明请参考 响应 Header

响应体参数

参数名称 类型 说明
code Integer 状态码,200 表示请求成功。
- data Object 频道房间信息。
channelName String 频道名称。
type String 频道类型,AUDIO:音频;VIDEO:视频;CUSTOM:自定义。
channelId String 频道 ID,服务器生成,确保唯一。
channelCreateTime Long 频道创建时间。
channelExpireTime Long 频道过期时间。
creator String 频道创建者账号。
- members Array of objects 频道成员列表。
accid String 成员账号 ID。
uid String 服务器生成的成员 ID。
deviceId String 成员设备 ID。
createTime Long 成员加入时间。
expireTime Long 成员过期时间。
ext String 扩展字段。

响应体示例

JSON{
  "code": 200,
  "data": {
    "ext": "test31-创建的房间",
    "creator": "test31",
    "channelCreateTime": 1754989274177,
    "members": [
      {
        "uid": 4503677459400116,
        "expireTime": 1754989574439,
        "createTime": 1754989274438,
        "accid": "test31"
      }
    ],
    "channelName": "avroom-v2pzw",
    "type": "AUDIO",
    "channelExpireTime": 1754996475012,
    "channelId": "039960db26934a5a8fad609647e2f3a6"
  }
}

错误码

完整错误码请参考 错误码

此文档是否对你有帮助?
有帮助
去反馈
  • 调用频率
  • 请求信息
  • 请求 URL
  • 请求头参数
  • 请求体参数
  • 请求示例
  • 响应示例
  • 响应头参数
  • 响应体参数
  • 响应体示例
  • 错误码