获取群/好友简要信息

POST

/finder/v2/api/contacts/getBriefInfo

请求参数

Header 参数

Body 参数application/json

示例

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

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '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-raw '{
    "appId": "{{appid}}",
    "wxids": [
        "wxid_phyyedw9xap22"
    ]
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "ret": 200,
    "msg": "获取联系人信息成功",
    "data": [
        {
            "userName": "wxid_phyyedw9xap22",
            "nickName": "Ashley",
            "pyInitial": "ASHLEY",
            "quanPin": "Ashley",
            "sex": 2,
            "remark": "",
            "remarkPyInitial": "",
            "remarkQuanPin": "",
            "signature": null,
            "alias": "zero-one_200906",
            "snsBgImg": null,
            "country": "AD",
            "bigHeadImgUrl": "https://wx.qlogo.cn/mmhead/ver_1/buiaXybHTBK3BuGr1edN72zBDermWVFJ7YC8Jib2RcCSdiauAtZcPgUQpdhE9KY5NsumDAWD16fsg3A6OKuhdEr97VAHdTGgk6R1Eibuj7ZNwJ4/0",
            "smallHeadImgUrl": "https://wx.qlogo.cn/mmhead/ver_1/buiaXybHTBK3BuGr1edN72zBDermWVFJ7YC8Jib2RcCSdiauAtZcPgUQpdhE9KY5NsumDAWD16fsg3A6OKuhdEr97VAHdTGgk6R1Eibuj7ZNwJ4/132",
            "description": null,
            "cardImgUrl": null,
            "labelList": "",
            "province": "",
            "city": "",
            "phoneNumList": null
        }
    ]
}

修改于 2025-09-08 10:02:26

获取通讯录列表缓存

获取群/好友详细信息