1. 联系人模块
QiWX开放平台
  • 开发前必读
  • 回调结构说明
  • 客户端用例
  • 登录模块
    • 创建设备(步骤1)
      POST
    • 二维码-获取(步骤2)
      POST
    • 二维码状态-检测(步骤3)
      POST
    • 二维码-code验证(步骤4)
      POST
    • 恢复设备
      POST
    • 用户登录(免扫码登录)
      POST
    • 用户状态
      POST
    • 停用设备
      POST
  • 回调模块
    • 设置回调URL
      POST
  • 联系人模块
    • 联系人详情-批量
      POST
    • 外部联系人分页
      POST
    • 内部联系人分页
      POST
    • 联系人搜索
      POST
    • 添加个微
      POST
    • 添加企微
      POST
    • 添加群成员好友
      POST
    • 添加企微名片
      POST
    • 添加删除联系人
      POST
    • 同意申请
      POST
    • 外部联系人信息-更新
      POST
    • 内部联系人信息-更新
      POST
    • 删除联系人
      POST
    • Openid
      POST
  • 群模块
    • 群分页
    • 群详情-批量
    • 群成员变动查询
    • 创建群
    • 修改群名称
    • 修改群备注
    • 修改群内昵称
    • 邀请/添加成员
    • 禁止群成员互相添加
    • 移除成员
    • 群二维码
    • 修改群公告
    • 添加群管理员
    • 取消群管理员
    • 退群
    • 转让群主
    • 群解散
    • 开启群改名
    • 开启群邀请确认
    • 接受群邀请-By链接
    • OpenID
  • 消息模块
    • 引用消息发送说明
    • 文件多媒体(下载/上传)
      • POST 本地文件上传
      • 企微文件异步上传
      • 企微大文件异步上传
      • 个微文件下载
      • 个微文件异步下载
      • 企微文件下载
      • 企微文件异步下载
      • 企微大文件异步下载
      • 文件上传-URL
      • 文件CDN转URL
    • 发送纯文本消息
    • 发送混合文本消息
    • 发送图片消息
    • 发送GIF表情消息
    • 发送视频消息
    • 发送文件消息
    • 发送语音消息
    • 发送链接消息
    • 发送小程序消息
    • 发送名片消息
    • 发送视频号消息
    • 发送位置消息
    • 撤回已发消息
    • 语音转文字-任务申请
    • 语音转文字-任务查询
    • 修改消息状态
    • 群消息置顶-列表
    • 群消息置顶-添加
    • 群消息置顶-移除
    • 群发助手发送
    • 群发助手-状态查询
    • 群发助手-规则查询
    • 同步历史消息分页
  • 会话模块
    • 会话分页
    • 会话组-编辑
    • 会话组-查询
  • 朋友圈模块
    • POST 朋友圈文件上传
    • 朋友圈列表分页
    • 获取详情-批量
    • 发送朋友圈
    • 删除朋友圈
    • 点赞/取消赞
    • 评论/追评
    • 评论删除
  • 个人模块
    • 生成二维码
    • 获取个人信息
    • 更新个人信息
    • 查询企业信息
    • 账号退出
    • 个人收藏-分页
    • 个人收藏-添加GIF表情
  • 标签模块
    • 列表分页
    • 个人标签-增删改
    • 客户标签-增删
  1. 联系人模块

外部联系人分页

POST
/work-weixin/api/doApi
• 通过查询 外部联系人分页 获取 userid,再调用 联系人详情 - 批量 接口进行查询联系人信息。
• 查询后保存 ,不用一直调用,后续可以根据回调保存数据

请求参数

Header 参数

Body 参数application/json必填

示例
{
   "method": "/contact/getWxContactList",
   "params": {
      "guid": "",
      "currentSeq": 0,
      "limit": 1,
      "bizType": 1
   }
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/work-weixin/api/doApi' \
--header 'X-QIWEI-TOKEN;' \
--header 'Content-Type: application/json' \
--data '{
   "method": "/contact/getWxContactList",
   "params": {
      "guid": "",
      "currentSeq": 0,
      "limit": 1,
      "bizType": 1
   }
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "code": 0,
    "data": {
        "currentSeq": 0,
        "contactCount": 0,
        "hasMore": true,
        "contactList": [
            {
                "acctid": "string",
                "addTime": 0,
                "alias": "string",
                "avatarUrl": "string",
                "contactType": 0,
                "corpFullName": "string",
                "corpId": "string",
                "corpName": "string",
                "desc": "string",
                "gender": 0,
                "groupId": "string",
                "internationCode": "string",
                "itemFlag": 0,
                "job": "string",
                "labelList": [
                    {
                        "businessType": 0,
                        "corpOrVid": 0,
                        "labelGroupId": 0,
                        "labelId": 0
                    }
                ],
                "unionid": "string",
                "applyReason": "string",
                "addCustomerTime": 0,
                "companyRemark": "string",
                "mobileRemark": [
                    "string"
                ],
                "mobile": "string",
                "nickname": "string",
                "position": "string",
                "realName": "string",
                "remark": "string",
                "sourceInfo": {
                    "addSource": 0,
                    "applyMode": 0,
                    "opUserId": 0,
                    "sourceRoomId": 0
                },
                "userId": "string",
                "seq": 0,
                "createSeq": 0
            }
        ]
    },
    "msg": "string"
}
修改于 2026-06-02 08:26:49
上一页
联系人详情-批量
下一页
内部联系人分页
Built with