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

GeHub 接入说明（Token、节点和幂等要求）

X-GEHUB-TOKEN 请在后台「客户端」创建或重置凭据后复制（不是 Client Secret 本身），仅通过 HTTPS 发送。节点由客户端默认绑定决定，appId 为兼容占位，不用于选择节点。写操作必须提供新的 Idempotency-Key（8–128 位字母、数字、点、下划线、冒号或短横线）；同一操作重试必须复用原值。危险操作另需 X-Confirm-Risk: destructive。首次微信登录和回调配置请在后台完成。客户端需启用对应模块权限。

POST

/gehub/v2/api/contacts/addContacts

调用时机说明

本接口建议在账号在线3天后再进行调用，以提高添加好友的成功率与稳定性。

添加结果说明

好友添加成功后，系统会通过回调消息推送一条包含 `v3` 字段的通知，可用于判断好友添加是否成功。

请求参数

Header 参数

X-GEHUB-TOKEN

string

必需

示例:

Idempotency-Keystring必需

必填，8–128 位；同一操作重试复用原值，新操作换新值。

Body 参数application/json

appId

string

兼容占位，可省略；按客户端绑定选择节点

scene

integer

必需

添加来源，同意添加好友时传回调消息xml中的scene值。
添加好友时的枚举值如下：
3 ：微信号搜索
4 ：QQ好友
8 ：来自群聊
15：手机号

option

integer

必需

操作类型，2添加好友 3同意好友 4拒绝好友

string

必需

通过搜索或回调消息获取到的v3

string

必需

通过搜索或回调消息获取到的v4

content

string

添加好友时的招呼语

必需

示例

{
    "appId": "{{appid}}",
    "scene": 3,
    "content": "hallo",
    "v4": "v4_000b708f0b04000001000000000054a9e826263634356493c57b8e651000000050ded0b020927e3c97896a09d47e6e9e455d674c2544e251e77c7cba08cc6cef8f7df9e52d2bd4a3cef771c8661331fa1939fbe54f4e479d6d9d4522d70aeba057ffd0dd82398730da44ee57332a7bdea4862304d4799758ba@stranger",
    "v3": "v3_020b3826fd030100000000003a070e7757675c000000501ea9a3dba12f95f6b60a0536a1adb690dcccc9bf58cc80765e6eb16bffa5996420bb1b2577634516ff82090419d8bdcd5689df8dfb21d40af93d286f72c3a0e8cfa6dcb68afed39226f008c6@stranger",
    "option": 2
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://wxapi.xiaoyu.fan/gehub/v2/api/contacts/addContacts' \
--header 'X-GEHUB-TOKEN: {{gehub-token}}' \
--header 'Idempotency-Key: {{idempotency-key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appId": "",
    "scene": 3,
    "content": "hallo",
    "v4": "v4_000b708f0b04000001000000000054a9e826263634356493c57b8e651000000050ded0b020927e3c97896a09d47e6e9e455d674c2544e251e77c7cba08cc6cef8f7df9e52d2bd4a3cef771c8661331fa1939fbe54f4e479d6d9d4522d70aeba057ffd0dd82398730da44ee57332a7bdea4862304d4799758ba@stranger",
    "v3": "v3_020b3826fd030100000000003a070e7757675c000000501ea9a3dba12f95f6b60a0536a1adb690dcccc9bf58cc80765e6eb16bffa5996420bb1b2577634516ff82090419d8bdcd5689df8dfb21d40af93d286f72c3a0e8cfa6dcb68afed39226f008c6@stranger",
    "option": 2
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

ret

integer

必需

msg

string

必需

示例

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

修改于 12 天前

搜索好友

删除好友