Gewechat

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

POST

/contacts/addContacts

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

请求参数

Header 参数

X-GEWE-TOKEN

string

必需

示例值:

Body 参数application/json

appId

string

设备ID

必需

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 --request POST '/contacts/addContacts' \
--header 'X-GEWE-TOKEN: {{gewe-token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appId": "{{appid}}",
    "scene": 3,
    "content": "hallo",
    "v4": "v4_000b708f0b04000001000000000054a9e826263634356493c57b8e651000000050ded0b020927e3c97896a09d47e6e9e455d674c2544e251e77c7cba08cc6cef8f7df9e52d2bd4a3cef771c8661331fa1939fbe54f4e479d6d9d4522d70aeba057ffd0dd82398730da44ee57332a7bdea4862304d4799758ba@stranger",
    "v3": "v3_020b3826fd030100000000003a070e7757675c000000501ea9a3dba12f95f6b60a0536a1adb690dcccc9bf58cc80765e6eb16bffa5996420bb1b2577634516ff82090419d8bdcd5689df8dfb21d40af93d286f72c3a0e8cfa6dcb68afed39226f008c6@stranger",
    "option": 2
}'

返回响应

🟢200成功

application/json

Body

ret

integer

必需

msg

string

必需

示例

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

搜索好友

删除好友