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

POST

/finder/v2/api/contacts/addContacts

本接口建议在线3天后再进行调用。
好友添加成功后，会通过回调消息推送一条包含v3的消息，可用于判断好友是否添加成功。

请求参数

Header 参数

Body 参数application/json

示例

{
    "appId": "{{appid}}",
    "scene": 15,
    "content": "HI",
    "v4": "v4_070b708f0b04000001000000000054a9e826263634356493c57b8e651000000050ded0b020927e3c97896a09d47e6e9e455d674c2544e251e77c7cba08cc6cef8f7df9e52d2bd4a3cef771c8661331fa1939fbe54f4e479d6d9d4522d70aeba057ffd0dd82398730da44ee57332a7bdea4862304d4799758ba@stranger",
    "v3": "v3_060b3826fd030100000000003a070e7757675c000000501ea9a3dba12f95f6b60a0536a1adb690dcccc9bf58cc80765e6eb16bffa5996420bb1b2577634516ff82090419d8bdcd5689df8dfb21d40af93d286f72c3a0e8cfa6dcb68afed39226f008c6@stranger",
    "option": 2
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://wx.chuapi.com/finder/v2/api/contacts/addContacts' \
--header 'X-finder-TOKEN: ' \
--header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJsb2dpbl91c2VyX2tleSI6IjAxNmM2ZDQ5LWIxNWMtNGRjMy05YzQzLWZmYzZmNDhhMTg3MyJ9.1JWq9ntjam20_XDlSbklWTxbV-vg-F_dY1LYVX05BndRAuaJbv3iSwoDY-BuMwe1sdKxDXtDTMWJgXNMff4nOg' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appId": "{{appid}}",
    "scene": 15,
    "content": "HI",
    "v4": "v4_070b708f0b04000001000000000054a9e826263634356493c57b8e651000000050ded0b020927e3c97896a09d47e6e9e455d674c2544e251e77c7cba08cc6cef8f7df9e52d2bd4a3cef771c8661331fa1939fbe54f4e479d6d9d4522d70aeba057ffd0dd82398730da44ee57332a7bdea4862304d4799758ba@stranger",
    "v3": "v3_060b3826fd030100000000003a070e7757675c000000501ea9a3dba12f95f6b60a0536a1adb690dcccc9bf58cc80765e6eb16bffa5996420bb1b2577634516ff82090419d8bdcd5689df8dfb21d40af93d286f72c3a0e8cfa6dcb68afed39226f008c6@stranger",
    "option": 2
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "ret": 200,
    "msg": "操作成功"
}

修改于 2026-05-19 05:30:39

搜索好友

删除好友