批量查询频道分组信息。

URL

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

请求参数

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

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

参数	类型	必须	说明
categoryIds	String	是	频道唯一标识列表，JSONArray格式，最多100个

返回参数

参数	说明
categoryInfos	频道分组列表信息，具体见下表

categoryInfos 参数如下：

参数	类型	说明
categoryId	Long	频道分组 ID
serverId	Long	服务器 ID
name	String	频道分组名称
custom	String	频道分组自定义扩展字段
owner	String	服务器所有者
viewMode	Integer	频道的查看模式，0-公开模式(默认)，1-私密模式
channelNumber	Integer	频道数量
validFlag	Integer	有效标志：0-无效，1-有效
createTime	Long	创建时间
updateTime	Long	更新时间

示例

cURL 请求示例

curlcurl -X POST -H "AppKey: go9dnk49b**lw0803mgq3" -H "Nonce: 4tggger**t23t" -H "CurTime: 1443592222" -H "CheckSum: 9e9db3b6c9abb2e1962cf3e6f7316fcc55583f86" -H "Content-Type: application/x-www-form-urlencoded" -d 'categoryIds=%5B%22123%22%2C%22234%22%5D' 'http://api.netease.im/nimserver/qchat/getChannelCategorys.action'

返回示例

http 响应:json

json"Content-Type": "application/json; charset=utf-8"
{
    "code": 200,
    "categoryInfos": [{
        "categoryId": 123,
        "serverId": 456,
        "name": "name",
        "custom": "custom",
        "owner": "zhangsan",
        "viewMode": 0,
        "channelNumber": 10,
        "validFlag": 1,
        "createTime": 1655197548301,
        "updateTime": 1655197548301
    }]
}
 

状态码

该接口在 HTTPS Body 中返回请求的状态码，以下仅列出与接口业务相关的状态码。完整状态码请参见状态码。

200、403、414、416、431、500