VideosApi

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

POST

/contacts/addContacts

基础API/联系人模块

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

请求参数

Header 参数

VideosApi-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_000b708f0b0400000100000000003d7981d847e9ba52ad58369039661000000050ded0b020927e3c97896a09d47e6e9e0e4fee530680092ce5c4540fe7d67ab41299d828ec61ef8f2c85781eccda3d98ae828cd74027198f19656c5200ae3d3f370da73840827cc2f163ce049e898eff555b3f698d4fdca831@stranger",
  "v3": "v3_020b3826fd03010000000000981a02bd13ae71000000501ea9a3dba12f95f6b60a0536a1adb670784c17485301375c790b64dfe27bcd7b2088cd53ec3d125d35dc0e0c93b1c94cfe954b3ed6eaca8d15a959123b3870aeadfb377703dd5d64bec39a38@stranger",
  "option": 2
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://api.videostui.com/finder/v2/api/contacts/addContacts' \
--header 'VideosApi-token: {{VideosApi-token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appId": "{{appid}}",
    "scene": 3,
    "content": "hallo",
    "v4": "v4_000b708f0b0400000100000000003d7981d847e9ba52ad58369039661000000050ded0b020927e3c97896a09d47e6e9e0e4fee530680092ce5c4540fe7d67ab41299d828ec61ef8f2c85781eccda3d98ae828cd74027198f19656c5200ae3d3f370da73840827cc2f163ce049e898eff555b3f698d4fdca831@stranger",
    "v3": "v3_020b3826fd03010000000000981a02bd13ae71000000501ea9a3dba12f95f6b60a0536a1adb670784c17485301375c790b64dfe27bcd7b2088cd53ec3d125d35dc0e0c93b1c94cfe954b3ed6eaca8d15a959123b3870aeadfb377703dd5d64bec39a38@stranger",
    "option": 2
}'

返回响应

🟢200成功

application/json

Body

ret

integer

必需

msg

string

必需

示例

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

修改于 2024-05-07 02:24:41

搜索好友

删除好友