接口文档开发者博客官网首页

获取通讯录列表(包含群聊)

POSThttps://api.wechatapi.net/contacts/fetchContactsList

接口说明

本接口为长耗时接口,耗时时间根据好友数量递增,若接口超时可通过获取通讯录列表缓存接口获取响应结果

注意:<font color='red'>本接口返回的群聊仅为保存到通讯录中的群聊</font>
此接口未返回的群聊,当有人在群内发言时,会有回调消息推送到对应的appid,拿到群id后可通过获取群信息接口拿到此群的信息做后续处理

请求参数

参数名位置类型必填说明
wechat-tokenheaderstring必填
appIdbodystring必填

设备ID

请求示例

Request JSON
{
  "appId": ""
}

响应示例

Response JSON
{
  "ret": 200,
  "msg": "操作成功",
  "data": {
    "friends": [
      "tmessage",
      "medianote",
      "qmessage",
      "qqmail",
      "wxid_910acevfm2nb21",
      "qqsafe",
      "wxid_9299552988412",
      "weixin",
      "exmail_tool",
      "wxid_mp05xmje0ctn22",
      "wxid_09oq4f4j4wg912",
      "wxid_6bfguz79h8n122",
      "wxid_lyuq4hr4lrjq22",
      "wxid_a1zqyljsrsdu12",
      "wxid_lv3pb3zhna3522",
      "wxid_k2biq6fuinsr22",
      "wxid_ujredjhxz9y712",
      "wxid_uwb7989u0jea12",
      "wxid_in46ey732vxu12",
      "wxid_3rvervwohj6921",
      "wxid_4wkls7tu62ua12",
      "wxid_g0bdknnotx2f12",
      "wxid_ce5fgp0icb3y21",
      "wxid_1482424825211",
      "wxid_vw3p4f6jy7bm12",
      "wxid_o2m8xm71c23522",
      "wxid_bclqpc2ho6o412",
      "wxid_98pjjzpiisi721",
      "wxid_noq2wsn5c8h222"
    ],
    "chatrooms": [
      "**********@chatroom",
      "*********@chatroom",
      "*********@chatroom",
      "*********@chatroom",
      "*********@chatroom"
    ],
    "ghs": [
      "gh_*********",
      "gh_*********",
      "gh_*********",
      "gh_*********",
      "gh_*********"
    ]
  }
}
接入 获取通讯录列表(包含群聊) 接口

注册即可获取 appId 与调用凭证,支持在线调试。

免费注册在线调试

本模块其他接口