获取群/好友简要信息

POST

/finder/v2/api/contacts/getBriefInfo

请求参数

Header 参数

Body 参数application/json

示例

{
    "appId": "{{appid}}",
    "wxids": [
        "wxid_9z0vy3t9z90x22"
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://wx.chuapi.com/finder/v2/api/contacts/getBriefInfo' \
--header 'X-finder-TOKEN: ' \
--header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJsb2dpbl91c2VyX2tleSI6IjAxNmM2ZDQ5LWIxNWMtNGRjMy05YzQzLWZmYzZmNDhhMTg3MyJ9.1JWq9ntjam20_XDlSbklWTxbV-vg-F_dY1LYVX05BndRAuaJbv3iSwoDY-BuMwe1sdKxDXtDTMWJgXNMff4nOg' \
--header 'Content-Type: application/json' \
--data '{
    "appId": "{{appid}}",
    "wxids": [
        "wxid_9z0vy3t9z90x22"
    ]
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "ret": 200,
    "msg": "获取联系人信息成功",
    "data": [
        {
            "userName": "wxid_9z0vy3t9z90x22",
            "nickName": "h.",
            "pyInitial": "H",
            "quanPin": "h",
            "sex": 2,
            "remark": "",
            "remarkPyInitial": "",
            "remarkQuanPin": "",
            "signature": "🍠",
            "alias": "G220Z918",
            "snsBgImg": null,
            "country": "CN",
            "bigHeadImgUrl": "",
            "smallHeadImgUrl": "",
            "description": null,
            "cardImgUrl": null,
            "labelList": null,
            "province": "Anhui",
            "city": "Tongling",
            "phoneNumList": null
        }
    ]
}

修改于 2026-05-19 05:19:49

获取通讯录列表缓存

获取群/好友详细信息