搜索好友

POST

/finder/v2/api/contacts/search

搜索的联系人信息若已经是好友，响应结果的v3则为好友的wxid
本接口返回的数据可通过添加联系人接口发送添加好友请求

请求参数

Header 参数

Body 参数application/json

示例

{
    "appId": "{{appid}}",
    "contactsInfo": "zhangch"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

成功示例异常示例

{
    "ret": 200,
    "msg": "操作成功",
    "data": {
        "v3": "v3_020b3826fd0301000000000020270f34e47a7c000000501ea9a3dba12f95f6b60a0536a1adb68c8ca877e5eda22dec3a8fbe277240c698a3ad8bbfd6e2cc116cee97dafc96f4346ca7d44b37e460fde6f8f6@stranger",
        "nickName": "Kc",
        "sex": 1,
        "signature": "I love music",
        "bigHeadImgUrl": "http://mmhead.hk.wechat.com/mmhead/ver_1/bo4aJ4wDEI82smz1ialgddV7jdR3EeAvsNdcVNr7upEnPibqsKu7puOcqicNGnl1cZGTg4VxWXKY2Bx6T5BdZdcZ7lvSLMuoTNjVM1dxMXI4Kw/0",
        "smallHeadImgUrl": "http://mmhead.hk.wechat.com/mmhead/ver_1/bo4aJ4wDEI82smz1ialgddV7jdR3EeAvsNdcVNr7upEnPibqsKu7puOcqicNGnl1cZGTg4VxWXKY2Bx6T5BdZdcZ7lvSLMuoTNjVM1dxMXI4Kw/132",
        "v4": "v4_000b708f0b040000010000000000ce39db71c004a4e2990b25f40b6a1000000050ded0b020927e3c97896a09d47e6e9efb90fdd92463bcf3caab4fccc5958653a4b159b3a24f54e253e369c0c9f2c9ca8059449fc24fd12459a9ca854d4751f5b42cd04b3dfa7c71d62566e7a808280eaa01eaf834b44e64@stranger"
    }
}

修改于 2026-05-19 05:25:10

获取群/好友详细信息

添加联系人/同意添加好友