跳到主要内容

获取群成员列表​

简要描述​

  • 获取群成员列表。

请求方式​

  • post

请求URL​

  • http://x.x.x.x:10002/group/get_group_member_list
header名示例值选填类型说明
operationID1646445464564必填stringoperationID用于全局链路追踪
tokeneyJhbxxxx3Xs必填string管理员token

请求参数示例​

{
  "groupID": "2559217223",
  "keyword": "nickname",
  "pagination": {
    "pageNumber": 1,
    "showNumber": 100
  }
}
字段名选填类型说明
groupID必填string群ID
keyword选填string关键词，用于搜索
pagination必填object分页参数结构体
pagination.pageNumber必填int当前页码，从1开始
pagination.showNumber必填int当前页请求数量

成功返回示例​

{
  "errCode": 0,
  "errMsg": "",
  "errDlt": "",
  "data": {
    "total": 5,
    "members": [
      {
        "groupID": "2559217223",
        "userID": "3034068043",
        "roleLevel": 20,
        "joinTime": 1687762198048,
        "nickname": "OK",
        "faceURL": "http://203.56.175.233:10002/third/object?name=%2Fdata%2Fuser%2F0%2Fcn.rentsoft.flutter.openim.consumer%2Fcache%2Fimage_cropper_1687330588901.jpg",
        "appMangerLevel": 0,
        "joinSource": 2,
        "operatorUserID": "4771680259",
        "ex": "",
        "muteEndTime": 0,
        "inviterUserID": "4771680259"
      },
      {
        "groupID": "2559217223",
        "userID": "3645617224",
        "roleLevel": 60,
        "joinTime": 1687762198048,
        "nickname": "霍去病",
        "faceURL": "http://203.56.175.233:10002/third/object?name=%2Fdata%2Fuser%2F0%2Fcn.rentsoft.flutter.openim.consumer%2Fcache%2Fimage_cropper_1687846002615.jpg",
        "appMangerLevel": 0,
        "joinSource": 2,
        "operatorUserID": "4771680259",
        "ex": "",
        "muteEndTime": 0,
        "inviterUserID": "4771680259"
      },
      {
        "groupID": "2559217223",
        "userID": "3791793226",
        "roleLevel": 20,
        "joinTime": 1687760824107,
        "nickname": "喔",
        "faceURL": "",
        "appMangerLevel": 0,
        "joinSource": 2,
        "operatorUserID": "4771680259",
        "ex": "",
        "muteEndTime": 0,
        "inviterUserID": "4771680259"
      },
      {
        "groupID": "2559217223",
        "userID": "4771680259",
        "roleLevel": 100,
        "joinTime": 1687760824107,
        "nickname": "Lumia",
        "faceURL": "http://203.56.175.233:10002/third/object?name=%2Fdata%2Fuser%2F0%2Fcn.rentsoft.flutter.openim.consumer%2Fcache%2Fimage_cropper_1687330764676.jpg",
        "appMangerLevel": 0,
        "joinSource": 2,
        "operatorUserID": "4771680259",
        "ex": "",
        "muteEndTime": 0,
        "inviterUserID": "4771680259"
      },
      {
        "groupID": "2559217223",
        "userID": "7117248489",
        "roleLevel": 20,
        "joinTime": 1687762198048,
        "nickname": "你好",
        "faceURL": "",
        "appMangerLevel": 0,
        "joinSource": 2,
        "operatorUserID": "4771680259",
        "ex": "",
        "muteEndTime": 0,
        "inviterUserID": "4771680259"
      }
    ]
  }
}

成功返回示例的参数说明​

参数名类型说明
errCodeint错误码,0表示成功
errMsgstring错误简要信息,无错误时为空
errDlterrDlt错误详细信息,无错误时为空
dataobject通用数据对象，具体结构见下方
totalint群成员总数
membersarray群成员信息列表

失败返回示例​

{
  "errCode": 1004,
  "errMsg": "RecordNotFoundError",
  "errDlt": ": [1004]RecordNotFoundError"
}

失败返回示例的参数说明​

参数名类型说明
errCodeint错误码,具体查看全局错误码文档
errMsgstring错误简要信息
errDlterrDlt错误详细信息