群API

获取群列表

GetIslandList

接口

地址版本方式权限
/api/v2/island/listv2POST不需要权限

描述

用于获取当前机器人加入的所有群的集合

入参

出参

字段类型说明
statusint返回码
messagestring返回信息
datalist<object>数据列表

数据

字段类型说明
islandSourceIdstring群ID
islandIdstring群号
islandNamestring群名称
coverUrlstring群头像
memberCountint群总人数
onlineMemberCountint群在线人数
defaultChannelIdstring默认访问频道ID
systemChannelIdstring系统消息频道ID

出参示例

{
    "status": 0,
    "message": "success",
    "data": [{
            "islandSourceId": "10001",
            "islandId": "100010",
            "islandName": "测试群",
            "coverUrl": "https://img.imdodo.com/dodo/730ace7b311879cee67bbbea41018bbe.png",
            "memberCount": 1000,
            "onlineMemberCount": 500,
            "defaultChannelId": "1000101",
            "systemChannelId": "1000102"
        }
    ]
}

获取群信息

GetIslandInfo

接口

地址版本方式权限
/api/v2/island/infov2POST不需要权限

描述

用于获取指定群的详细信息

入参

字段类型必传说明
islandSourceIdstring群ID

出参

字段类型说明
statusint返回码
messagestring返回信息
dataobject返回数据

数据

字段类型说明
islandSourceIdstring群ID
islandNamestring群名称
coverUrlstring群头像
memberCountint群总人数
onlineMemberCountint群在线人数
descriptionstring群简介
defaultChannelIdstring默认访问频道ID
systemChannelIdstring系统消息频道ID
ownerDodoSourceIdstring群主DoDoID

入参示例

{
    "islandSourceId": "10001"
}

出参示例

{
    "data": {
        "islandSourceId": "10001",
        "islandName": "测试群",
        "coverUrl": "https://img.imdodo.com/dodo/730ace7b311879cee67bbbea41018bbe.png",
        "memberCount": 1000,
        "onlineMemberCount": 500,
        "description": "这个是一个测试群",
        "defaultChannelId": "1000101",
        "systemChannelId": "1000102",
        "ownerDodoSourceId": "8527"
    },
    "status": 0,
    "message": "success"
}

获取群等级排行榜

GetIslandLevelRankList

接口

地址版本方式权限
/api/v2/island/level/rank/listv2POST不需要权限

描述

用于获取指定群的群等级排行榜

提示

只对开通了群等级的群有效

入参

字段类型必传说明
islandSourceIdstring群ID

出参

字段类型说明
statusint返回码
messagestring返回信息
datalist<object>数据列表

数据

字段类型说明
dodoSourceIdstringDoDoID
nickNamestring群昵称
levelint等级
rankint排名,返回前100名

入参示例

{
    "islandSourceId": "10001"
}

出参示例

{
    "status": 0,
    "message": "success",
    "data": [{
            "dodoSourceId": "666666",
            "nickName": "测试群昵称",
            "level": 1,
            "rank": 1
        }
    ]
}

获取群禁言名单

GetIslandMuteList

接口

地址版本方式权限
/api/v2/island/mute/listv2POST成员管理-管理成员

描述

用于获取指定群的群禁言名单

入参

字段类型必传说明
islandSourceIdstring群ID
pageSizeint页大小,最大100
maxIdlong上一页最大ID值,为提升分页查询性能,需要传入上一页查询记录中的最大ID值,首页请传0

数据

字段类型说明
maxIdobject最大ID值
listlist<object>数据列表

列表项

字段类型说明
dodoSourceIdstringDoDoID

入参示例

{
    "islandSourceId": "10001",
    "pageSize": 100,
    "maxId": 0
}

出参示例

{
    "data": {
        "maxId": 12345,
        "list": [{
                "dodoSourceId": "666666"
            }
        ]
    },
    "status": 0,
    "message": "success"
}

获取群封禁名单

GetIslandBanList

接口

地址版本方式权限
/api/v2/island/ban/listv2POST成员管理-管理成员

描述

用于获取指定群的群封禁名单

入参

字段类型必传说明
islandSourceIdstring群ID
pageSizeint页大小,最大100
maxIdlong上一页最大ID值,为提升分页查询性能,需要传入上一页查询记录中的最大ID值,首页请传0

数据

字段类型说明
maxIdobject最大ID值
listlist<object>数据列表

列表项

字段类型说明
dodoSourceIdstringDoDoID

入参示例

{
    "islandSourceId": "10001",
    "pageSize": 100,
    "maxId": 0
}

出参示例

{
    "data": {
        "maxId": 12345,
        "list": [{
                "dodoSourceId": "666666"
            }
        ]
    },
    "status": 0,
    "message": "success"
}