获取群成员列表

GeHub 接入说明（Token、节点和幂等要求）

X-GEHUB-TOKEN 请在后台「客户端」创建或重置凭据后复制（不是 Client Secret 本身），仅通过 HTTPS 发送。节点由客户端默认绑定决定，appId 为兼容占位，不用于选择节点。写操作必须提供新的 Idempotency-Key（8–128 位字母、数字、点、下划线、冒号或短横线）；同一操作重试必须复用原值。危险操作另需 X-Confirm-Risk: destructive。首次微信登录和回调配置请在后台完成。客户端需启用对应模块权限。

POST

/gehub/v2/api/group/getChatroomMemberList

请求参数

Header 参数

X-GEHUB-TOKEN

string

必需

示例:

Body 参数application/json

appId

string

兼容占位，可省略；按客户端绑定选择节点

chatroomId

string

群ID

必需

示例

{
    "appId": "{{appid}}",
    "chatroomId": "34757816141@chatroom"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://wxapi.xiaoyu.fan/gehub/v2/api/group/getChatroomMemberList' \
--header 'X-GEHUB-TOKEN: {{gehub-token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appId": "",
    "chatroomId": "34757816141@chatroom"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

ret

integer

必需

msg

string

必需

data

object

必需

memberList

array [object]

群成员列表

必需

chatroomOwner

null

群主的wxid

必需

adminWxid

null

管理的wxid

必需

示例

{
    "ret": 200,
    "msg": "操作成功",
    "data": {
        "memberList": [
            {
                "wxid": "zhangchuan2288",
                "nickName": "朝夕。",
                "inviterUserName": null,
                "memberFlag": 1,
                "displayName": null,
                "bigHeadImgUrl": "https://wx.qlogo.cn/mmhead/ver_1/T0MtLBu618rUlZqaAiaWfucmVibiawiciaSibPfz11siaLZr0qSxQTAR9lu7YicDwYAHNia1je79icxul6bzQ4LLZopiaM9EdYAEublPCLV29QKLv26ictBHjWsWnE0lvYGjibB9DkE6q/0",
                "smallHeadImgUrl": "https://wx.qlogo.cn/mmhead/ver_1/T0MtLBu618rUlZqaAiaWfucmVibiawiciaSibPfz11siaLZr0qSxQTAR9lu7YicDwYAHNia1je79icxul6bzQ4LLZopiaM9EdYAEublPCLV29QKLv26ictBHjWsWnE0lvYGjibB9DkE6q/132"
            },
            {
                "wxid": "wxid_phyyedw9xap22",
                "nickName": "Ashley",
                "inviterUserName": "zhangchuan2288",
                "memberFlag": 1,
                "displayName": null,
                "bigHeadImgUrl": "https://wx.qlogo.cn/mmhead/ver_1/5ibSibfNKwpv0TLLuSFv2hibEBqShib4BKsaxHZ2v10y9F93ibO5lK4bwib47qtuwsLZD8HY7fVicibWlWvehCLDCdicy38NaIbVupuMZMDwiaXozjUhk/0",
                "smallHeadImgUrl": "https://wx.qlogo.cn/mmhead/ver_1/5ibSibfNKwpv0TLLuSFv2hibEBqShib4BKsaxHZ2v10y9F93ibO5lK4bwib47qtuwsLZD8HY7fVicibWlWvehCLDCdicy38NaIbVupuMZMDwiaXozjUhk/132"
            },
            {
                "wxid": "wxid_0xsqb3o0tsvz22",
                "nickName": "G",
                "inviterUserName": "zhangchuan2288",
                "memberFlag": 2049,
                "displayName": "G1",
                "bigHeadImgUrl": "https://wx.qlogo.cn/mmhead/ver_1/FMkteDauMN35F3lhfavibDYpGibfHqrsMICtqBbWDfwfQOnIYfgHBpOJLLbac0Wf3odowXcePFHMzj954EeFOiaKcsgIaMedw5KWZhBpaLsFfSK5HNAE7AQODQ1FfrPiaTCh/0",
                "smallHeadImgUrl": "https://wx.qlogo.cn/mmhead/ver_1/FMkteDauMN35F3lhfavibDYpGibfHqrsMICtqBbWDfwfQOnIYfgHBpOJLLbac0Wf3odowXcePFHMzj954EeFOiaKcsgIaMedw5KWZhBpaLsFfSK5HNAE7AQODQ1FfrPiaTCh/132"
            },
            {
                "wxid": "wxid_8pvka4jg6qzt22",
                "nickName": "白开水加糖",
                "inviterUserName": "wxid_phyyedw9xap22",
                "memberFlag": 2049,
                "displayName": null,
                "bigHeadImgUrl": "https://wx.qlogo.cn/mmhead/ver_1/3d34Q9DWL6pHiaASIBMIG3J9deRhwz4yKpZxGibDqiaRGmF6XckV0VSeRTGHSTq55bSwK1qF4Sy1JVXIkB7tYHpR4qPh3ECcodpkqRQjSwKUa4/0",
                "smallHeadImgUrl": "https://wx.qlogo.cn/mmhead/ver_1/3d34Q9DWL6pHiaASIBMIG3J9deRhwz4yKpZxGibDqiaRGmF6XckV0VSeRTGHSTq55bSwK1qF4Sy1JVXIkB7tYHpR4qPh3ECcodpkqRQjSwKUa4/132"
            }
        ],
        "chatroomOwner": "zhangchuan2288",
        "adminWxid": [
            "wxid_8pvka4jg6qzt22"
        ]
    }
}

修改于超过 2 年前

获取群信息

获取群成员详情