API 参考
圈组

获取聊天室地址

更新时间: 2024/07/17 17:57:35

创建聊天室后,您可通过调用 IM 服务端 API 请求聊天室地址(推荐),也可通过调用 SDK 相关接口建立聊天室长连接获取聊天室地址。

URL

httpPOST https://api.netease.im/nimserver/chatroom/requestAddr.action HTTP/1.1
Content-Type:application/x-www-form-urlencoded;charset=utf-8

请求参数

  • POST 请求中 Headers 的设置请参考API调用方式

  • POST 请求中 Body 的设置如下:

参数类型必须说明
roomid long 聊天室id
accid String 进入聊天室的账号
clienttype int 1:weblink(客户端为web端时使用); 2:commonlink(客户端为非web端时使用);3:wechatlink(微信小程序使用), 默认1
clientip String客户端ip,传此参数时,会根据用户ip所在地区,返回合适的地址

示例

cURL请求示例

curlcurl -X POST -H "CheckSum: 51eb13ea5ee3**1c65c7866c366" -H "AppKey: f1234540c12**3456847aaaaaa" -H "Nonce: 1" -H "CurTime: 1451217708" -H "Content-Type: application/x-www-form-urlencoded" -d 'roomid=66&accid=zhangsan&clienttype=1' 'https://api.netease.im/nimserver/chatroom/requestAddr.action'

返回示例

请求成功的返回示例如下:

json"Content-Type": "application/json; charset=utf-8"
{
  "addr": [
    "testchat.netease.im:6666",
    "testchat.netease.im:8888"
  ],
  "code": 200
}

状态码

该接口在 HTTPS Body 中返回请求的状态码,状态码详情请参见状态码

此文档是否对你有帮助?
有帮助
去反馈
  • URL
  • 请求参数
  • 示例
  • cURL请求示例
  • 返回示例
  • 状态码