API接口文档 (小组级)
  1. 基础接口
API接口文档 (小组级)
  • 接入说明
  • 快速入门
    • 加密手机号加好友方案
    • 加密版接口
    • 如何发送一条消息
    • 通过接口实现群发
    • 加密externalUserId打通方案
    • unionId打通方案
  • 接口文档
    • 小组级接口
      • 小组级接口说明
      • 基础接口
        • 获取托管企业微信列表
          GET
        • 获取个人微信授权到期及首次扫码登录的时间
          GET
        • 获取联系人列表
          GET
        • 获取群列表
          GET
        • 获取群列表(不包含成员信息)
          GET
        • 发送系统通知
          POST
        • 获取自定义标签列表
          GET
        • 获取组内员工列表
          GET
      • 群聊接口
        • 加入群聊
        • 退出群聊事件回调
        • 加入群聊事件回调
        • 更改群名事件回调
        • 创建群聊
        • 通过联系人id获取联系人所在群聊
      • 会话接口
        • 开发建议
        • 获取指定会话
        • 获取会话列表
        • 会话事件回调
        • 分配会话
        • 消息置顶
      • 加好友接口
        • 通过手机号加好友接口
        • 加好友任务成功回调
        • 好友通过后回调
        • 群聊加好友接口
      • 消息接口
        • 获取原图
        • 发送消息
        • 小组级接收消息回调
        • 聊天历史
        • 企微id发消息
      • 群发接口
        • 创建群发
        • 创建群发 Copy
        • 重发群发
        • 取消群发
        • 删除群发
        • 群发回调
        • 获取群发任务的失败列表
        • 获取群发任务的没有发送的列表
        • 获取群发任务的进度
    • 自建应用依赖接口
      • 自建应用依赖接口说明
      • 客户信息接口
        • 修改客户备注
        • 添加跟进记录
      • 雷达接口
        • 雷达访问接口
      • id信息获取接口
        • 获取chatId
        • 通过unionId获取chatId
    • 废弃接口
      • 会话小结
      • 渠道二维码管理
        • 获取渠道列表(企业控制台数据)
      • 通过企微id群聊加好友
      • 新增客户
      • 获取成员详情
      • 获取客户列表(2023/12/05 废弃)
      • 秒回数据同步
      • 获取群列表
      • 获取客户详情
      • 获取群信息
      • 绑定企业微信官方ID
      • 通过externalUserId获取chatId
      • 获取群列表(2023/2/05 废弃)
  • 更新日志
    • 更新日志
  1. 基础接口

获取群列表(不包含成员信息)

GET
/room/simpleList

请求参数

Query 参数
token
string 
调用接口凭证
必需
current
string 
必需
页码, 默认为0,即第一页
示例值:
2
pageSize
string 
必需
每页数量, 默认为10,最大为100
示例值:
5
wxid
string 
可选
需要搜索的群聊系统id,当传入此参数时,current 和 pageSize 失效

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://aa-stream-api.ddregion.com/room/simpleList?token=&current=2&pageSize=5&wxid='

返回响应

🟢200成功
application/json
Body
code
number 
返回码
必需
data
array [object {11}] 
群数据
必需
chatId
string 
该群组的对话id
必需
botInfo
object 
所属托管账号信息
必需
wxid
string 
群聊的系统id
必需
topic
string 
群名称
可选
avatarUrl
string 
群头像
可选
ownerId
string 
群主的系统联系人id
可选
labels
array [object {2}] 
自定义标签信息
可选
wecomChatId
string 
群聊企业微信id
可选
deleted
boolean 
群聊是否已经不在
必需
external
boolean 
群聊 true外部群聊 false内部群聊
可选
memberCount
number 
群成员人数
可选
page
object 
分页信息
必需
current
integer 
当前页数
必需
total
integer 
总数
必需
示例
{
  "code": 0,
  "data": [
    {
      "chatId": "string",
      "botInfo": {
        "wxid": "string",
        "weixin": "string",
        "nickName": "string"
      },
      "wxid": "string",
      "topic": "string",
      "avatarUrl": "string",
      "ownerId": "string",
      "labels": [
        {
          "id": "string",
          "name": "string"
        }
      ],
      "wecomChatId": "string",
      "deleted": true,
      "external": true,
      "memberCount": 0
    }
  ],
  "page": {
    "current": 0,
    "total": 0
  }
}
上一页
获取群列表
下一页
发送系统通知
Built with