获取通讯录列表

POST

/v1/contact/fetchContactList

获取微信通讯录列表，包括好友、微信群和关注的公众号，只返回ID

本接口返回的群聊仅为保存到通讯录中的群聊；未保存通讯录的群，需要根据消息推送自行判断并保存

微信通讯录同步耗时较长，账号登录后，平台会自动进行一次同步并缓存，本接口是从缓存中获取。如果遇到“通讯录同步进行中”错误，请等待一定时间后再次调用

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "appId": "string",
    "contactType": 0
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.wekeapi.com/api/v1/contact/fetchContactList' \
--header 'X-Access-Token;' \
--header 'Content-Type: application/json' \
--data '{
    "appId": "string",
    "contactType": 0
}'

返回响应

⚪0

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "data": {
        "chatrooms": [
            "string"
        ],
        "friends": [
            "string"
        ],
        "ghs": [
            "string"
        ]
    },
    "message": "OK"
}

修改于 2026-05-25 09:39:48

退出登录

获取联系人/群/公众号简要信息