WTAPI开发文档
  1. 联系人接口
  • 平台简介
  • 快速入门
  • 接入开发规范
  • 消息订阅收发
  • 综合问题排查
  • 回调信息速览
  • 回调消息详解
  • 更新日志
  • API模块
    • 登录接口
      • ①获取登录二维码
      • ②执行登录
      • 弹窗登录
      • ③设置回调地址
      • 检查是否在线
      • 退出
      • 断线重连
    • 联系人接口
      • 获取通讯录列表
        POST
      • 获取通讯录列表缓存
        POST
      • 获取群/好友简要信息
        POST
      • 获取群/好友详细信息
        POST
      • 搜索好友
        POST
      • 添加联系人/同意添加好友
        POST
      • 删除好友
        POST
      • 设置好友仅聊天
        POST
      • 设置好友备注
        POST
      • 获取手机通讯录
        POST
      • 上传手机通讯录
        POST
      • 搜索企微
        POST
      • 添加企微好友
        POST
      • 同步企微好友
        POST
      • 获取企微好友详情
        POST
    • 消息接口
      • 下载
        • 下载文件
        • 下载图片
        • 下载语音
        • 下载视频
        • 下载emoji和表情包
      • 发送文字消息
      • 发送文件消息
      • 发送图片消息
      • 发送语音消息
      • 发送视频消息
      • 发送链接消息
      • 发送名片消息
      • 发送emoji消息
      • 发送appmsg消息
      • 发送小程序消息
      • 转发文件
      • 转发图片
      • 转发视频
      • 转发链接
      • 转发小程序
      • 撤回消息
    • 个人接口
      • 获取个人资料
      • 获取自己的二维码
      • 获取设备记录
      • 隐私设置
      • 修改个人信息
      • 修改头像
    • 标签接口
      • 添加标签
      • 删除标签
      • 标签列表
      • 修改好友标签
    • 群聊接口
      • 创建微信群
      • 修改群名称
      • 修改群备注
      • 修改我在群内的昵称
      • 邀请/添加 进群
      • 删除群成员
      • 退出群聊
      • 解散群聊
      • 获取群信息
      • 获取群成员列表
      • 获取群成员详情
      • 设置群公告
      • 获取群公告
      • 同意进群
      • 添加群成员为好友
      • 获取群二维码
      • 群保存到通讯录
      • 管理员操作
      • 聊天置顶
      • 设置消息免打扰
      • 扫码进群
      • 确认进群申请
    • 朋友圈接口
      • 自己的朋友圈列表
      • 联系人的朋友圈列表
      • 点赞/取消点赞
      • 删除自己朋友圈
      • 设置朋友圈可见范围
      • 是否允许陌生人查看朋友圈
      • 设置某条朋友圈为隐私/公开
      • 下载朋友圈视频
      • 发送文字朋友圈
      • 发送图片朋友圈
      • 发送视频朋友圈
      • 发送链接朋友圈
      • 上传朋友圈图片
      • 上传朋友圈视频
      • 转发朋友圈
      • 某条朋友圈详情
      • 评论/删除评论
    • 收藏夹接口
      • 同步收藏夹
      • 获取收藏夹内容
      • 删除收藏夹
    • 视频号接口
      • 获取我的视频号信息
      • 修改我的视频号信息
      • 用户主页
      • 关注
      • 评论
      • 浏览
      • 发布视频-新
      • 关注列表
      • 消息列表
      • 评论列表
      • 获取赞与收藏的视频列表
      • 搜索视频号
      • 创建视频号
      • 同步私信消息
      • 根据id点赞
      • 根据id点小红心
      • 发送视频号消息
      • 发送视频号朋友圈
      • 获取私信人信息
      • 发私信文本消息
      • 发私信图片消息
      • 扫码关注
      • 搜索并关注
      • 扫码浏览
      • 扫码评论
      • 扫码点赞
      • 扫码点小红心
      • 延迟点赞、小红心
      • 扫码登录视频号助手
      • 扫码获取视频详情
      • 我的视频号二维码
      • 上传CDN视频
      • 发布CDN视频
  1. 联系人接口

获取通讯录列表

POST
/finder/v2/api/contacts/fetchContactsList
本接口为长耗时接口,耗时时间根据好友数量递增,若接口返回超时可通过获取通讯录列表缓存接口获取响应结果
本接口返回的群聊仅为保存到通讯录中的群聊,若想获取会话列表中的所有群聊,需要通过消息订阅做二次处理。原因:当未获取的群有成员在群内发消息的话会有消息回调, 开发者此刻调用获取群详情接口查询群信息入库保存即可,比如说手机上三年前不说话的群,侧滑删除了,用户手机上也不会看到被删除的群聊的 ,但是有群成员说了话他会显示,原理就是各个终端(Android、IOS、桌面版微信)取得了消息回调,又去获取群详情信息,本地数据库缓存了下来,显示的手机群聊,让用户感知的。

请求参数

Header 参数

Body 参数application/json

示例
{
    "appId": "{{appid}}"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://wx.chuapi.com/finder/v2/api/contacts/fetchContactsList' \
--header 'X-finder-TOKEN: ' \
--header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJsb2dpbl91c2VyX2tleSI6IjAxNmM2ZDQ5LWIxNWMtNGRjMy05YzQzLWZmYzZmNDhhMTg3MyJ9.1JWq9ntjam20_XDlSbklWTxbV-vg-F_dY1LYVX05BndRAuaJbv3iSwoDY-BuMwe1sdKxDXtDTMWJgXNMff4nOg' \
--header 'Content-Type: application/json' \
--data '{
    "appId": "{{appid}}"
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "ret": 200,
    "msg": "操作成功",
    "data": {
        "friends": [
            "weixin",
            "fmessage",
            "medianote",
            "floatbottle",
            "wxid_umuxo7nlst5t12",
            "qmessage",
            "wxid_9z0vy3t9z90x22",
            "wxid_br88xhuif7k322",
            "wxid_mdueitt68qf622",
            "wxid_2ewv23l5h8sl12",
            "wxid_8kwvflc804pa12",
            "wxid_uly1n0pp731t22",
            "wxid_l2udz60b2tr512",
            "wxid_2sljckekyl1w22",
            "wxid_fs9khsrsikrs22",
            "wxid_ktw4r8m6knml22",
            "wxid_ap8o800psx1f22",
            "wxid_8euwuy1f5vxa22",
            "wxid_lpy37amh1ihb12",
            "wxid_t70ogud591l922",
            "wxid_i4zw3y844blp22",
            "wxid_ce9oiatu8apn22",
            "wxid_hyya22y9vony22",
            "wxid_ynxiuq6vvvso22",
            "qqmail",
            "wxid_pkwydb25iqfq12",
            "wxid_kxlubty1fx6f22",
            "wxid_beavi6vdqvfz22",
            "wxid_tixy9fox24ea22",
            "wxid_lydac4lvelu612",
            "wxid_mw42yg8pkg8r12",
            "wxid_cp03zrbidf0622",
            "wxid_axlksoajwyeg22",
            "wxid_kjfg6chpv9q222",
            "wxid_iv697wedg8t422",
            "wxid_kcmw4vknyjzd22",
            "mimang052810",
            "wxid_ex9npilhxeju22",
            "wxid_ye8bfdoitz0322",
            "zxc451053037",
            "wxid_09owiym3klh822",
            "wxid_cqe2nnfyvzgc22",
            "wxid_c29gve71rchf22",
            "bingdepengyou",
            "wxid_4yphqwnzhr3422",
            "wxid_ujfo5kylcb3b22",
            "wxid_bctwjrorjf8y22",
            "wxid_z2wx2y53v6an12",
            "wxid_f6hmevd0uub522",
            "wxid_xwgi5rn7rp2512",
            "wxid_7ijhvykleawl22",
            "wxid_crw6lr6qhtjk22",
            "wxid_aw9qhxlk36ms12",
            "wxid_k9hjw3c7fjsr22",
            "wxid_sh9nk7hzez7s22",
            "wxid_sn8pym8t2sj722",
            "wxid_wysyd2ivqj2p22",
            "wxid_fakxj63ry1v922",
            "wxid_z2s6rh408hcl12",
            "wxid_w9j55nqahjy722",
            "wxid_irla8s6xyr1912",
            "wxid_3b56aq7gklnb22",
            "wxid_24d2soibp1oe22",
            "wxid_0bx9x83q64vj22",
            "wxid_sk0ml8427hdo22",
            "wxid_mmhidw28t18v22",
            "wxid_jwfmiqsz8imv22",
            "wxid_nowofg51g7w522",
            "wxid_ba8c73hr3cj019",
            "wxid_ze0eaqzh5ns122",
            "wxid_ll0kpepy5ikg22",
            "wxid_3g85l6yelaa712",
            "wxid_bn6ra3sglmft22",
            "wxid_c5z73b7frnr522",
            "wxid_vz5rxbvj9tvf22",
            "wxid_3ol3pe1l7won22",
            "wxid_1pf3p3uksq9q22",
            "wxid_anp5hvxzaujx12",
            "wxid_oucomzmlq9zg22",
            "wxid_ptnkwhgyossh22",
            "wxid_gmujgi3y2hsb22",
            "wxid_vtb05r0uamvs12",
            "wxid_yqq6067vpavc29",
            "wxid_g7ufvpocf4s112",
            "wxid_j8hxtt24k1l912",
            "wxid_p350foo25shl22",
            "wxid_4oxlqixchsn722",
            "wxid_rx3zzzsr14di12",
            "wxid_28g692habbw522",
            "wxid_3omjcf87yg6j22",
            "wxid_amt6fmniom4422",
            "wxid_c78olt9fkhqp12",
            "wxid_4yh4ihvzf96w22",
            "wxid_1ykylzotsmd821",
            "wxid_ptj8i2butn9h22",
            "wxid_d855t1458upj12",
            "wxid_u6pnqfc6huhb21",
            "wxid_euis2eb6f6z622",
            "wxid_1wlg8z1gbphv22",
            "wxid_djksdvejnubf22",
            "wxid_totsxr34r0zn22",
            "wxid_1gvbgee4oqkj22",
            "wxid_ab9xphcnwtm122",
            "wxid_r52wh1yqtblw21",
            "wxid_2h68hkyazsj422",
            "wxid_u9bfnbhohnen22",
            "wxid_nc0afzqe7syk22",
            "wxid_d3winvn3nzj022",
            "wxid_8jto1hm8nf3r22",
            "wxid_ahozzesv3elw12",
            "wxid_hlr3hhmfif3b22",
            "wxid_pa5178hdujlc29",
            "wxid_m1lyen8odaq622",
            "wxid_fxzuss23xe1622",
            "wxid_37m5vfkxnm7c22",
            "wxid_puu6payxmn7f12",
            "wan5820f",
            "wxid_7u9jnx3df70k12",
            "wxid_5htnh9qrh40n22",
            "wxid_cirntgzhydg922",
            "wxid_5osclvu3ablw22",
            "wxid_gxbxepxore9h22",
            "wxid_tq02wpsxj5yk12",
            "wxid_suadtroo7iqf22",
            "wxid_0y3rge7gho1w12",
            "wxid_1t6yowv7mk3y22",
            "wxid_e4njadqa4vqs22",
            "wxid_65sdggi6hjjr22",
            "jcw1322191763",
            "wxid_6kqp8liywc5n12",
            "wxid_iqz2mk7ds47f22",
            "wxid_1dtfj7krh89k12",
            "wxid_lcppnnzi4c1g12",
            "wxid_vhwm7krfywkt22",
            "wxid_2aqdyc76tlfm22",
            "wxid_vyn6ywvndcfn22",
            "wxid_t2chdeoczbz622",
            "wxid_ynjxcf8zt6di12",
            "wxid_0v4vpcv73cb922",
            "filehelper",
            "wxid_bimwu9xz413v22",
            "wxid_nrkrbtndxf2i22",
            "wxid_ibw2mw0dekfq22",
            "wxid_w5uyp65jcvg222",
            "wxid_mcijgiwwnfqw21",
            "wxid_awz1o3yapu2i12",
            "wxid_4jy8cpfd1ou922",
            "wxid_9lg0lhh3olv222",
            "wxid_8o4bamk5apx122",
            "wxid_lh184am3a2zt22",
            "wxid_gspfywez2c2i22",
            "wxid_8ckssi5vatr522",
            "wxid_ihrx52vc49hs12",
            "caoxuewen793723",
            "wxid_xu2d3ap3yxbz21",
            "wxid_4tgr2xc64avc22",
            "wxid_x4wllshr47b922",
            "wxid_h22g4rncl3uq22",
            "wxid_s2mhekefuvg522",
            "wxid_q0othqwlw6ci22",
            "wxid_muv2qvsj0j7522",
            "wxid_l4158y6fvqd422",
            "wxid_i1cc070vhehs22",
            "wxid_lzdrj1i1t1t122",
            "wxid_7u1labp52w4d19",
            "wxid_kzqnhq6whmh222",
            "wxid_s5haby2cea6p22",
            "wxid_mt798s3gakyu22",
            "wxid_dybis7cgyryg22",
            "wxid_b4eo4u6yh2a022",
            "wxid_x9mkjm4z6y522",
            "wxid_erndchu1f31322",
            "wxid_gohf5yop1rg522",
            "wxid_0zjpvoofkqtx22",
            "wxid_vd5grhncd3cz22",
            "wxid_v83s3bx58p5j22",
            "wxid_2p2nmqlm7fj429",
            "xuan588888888",
            "wxid_a638h9n5el6c12",
            "wxid_und8m2qzwjqf22",
            "wxid_rhosy8gtow9722",
            "wxid_v5z9pqicwzlv22",
            "wxid_0de70gzm5p0322",
            "wxid_ug3syt2w9hu622",
            "wxid_l6mwuwljigm522",
            "wxid_atopsulrk4ud19",
            "wxid_4rfjfkxlj8cc22",
            "wxid_lyoxd25bq0rc22",
            "wxid_wf966xkzpyo22",
            "wxid_gwf8jpy9e6fg12",
            "wxid_deoqjkl4krgw22",
            "wxid_8t5gs8b1zayn12",
            "wxid_0xf1owycjed422",
            "wxid_mqmdvc4h9pya22",
            "wxid_34uubs9gftx711",
            "wxid_ylzhijnlsdi112",
            "wxid_baijrnkpt8j022",
            "wxid_aw6qnrjznvb522",
            "wxid_qt23uyyokwne22",
            "wxid_v1cw2kjc5ih812",
            "wxid_uubb4hc5nqny22",
            "wxid_h5nl1h627a2c22",
            "wxid_2vcfgysgjbqw22",
            "wxid_85l4h6snshan22",
            "wxid_d2btsa6jegjk22",
            "LOVE923979928",
            "wxid_htrvas587yu622",
            "wxid_8fvauuda4ykc22",
            "suphy818"
        ],
        "chatrooms": [
            "17226018258@chatroom",
            "46165002279@chatroom",
            "48315660064@chatroom",
            "6406302200@chatroom",
            "13620970622@chatroom",
            "47503820790@chatroom",
            "43405632344@chatroom",
            "21215962627@chatroom",
            "56831803594@chatroom"
        ],
        "ghs": [
            "gh_3dfda90e39d6",
            "gh_59e8fba3a52c",
            "gh_1d33166630a5",
            "gh_cfb3533bbdda",
            "gh_1b3d7804b344"
        ]
    }
}
修改于 2026-05-19 05:17:47
上一页
断线重连
下一页
获取通讯录列表缓存
Built with