删除好友 DeleteFriend--实时音视频-火山引擎

文档中心

立即注册

导航

实时音视频

删除好友 DeleteFriend

最近更新时间：2023.11.27 20:36:34首次发布时间：2023.08.16 19:53:36

你可以使用此接口删除好友。

接口行为

你可以调用 DeleteFriend 接口，指定你所属的 AppId、用户 ID 和好友 ID 双向删除好友。一次最多支持删除 10 个好友。

调用接口

关于调用接口的服务地址、通信协议、字符编码和签名机制，参看调用 OpenAPI。

接口限制

QPS 不得超过 50。

请求方式

使用 POST 方式发起请求。

请求参数

Query

参数名	类型	必填	示例值	描述
Action	String	是	`DeleteFriend`	接口名称，本接口取值：`DeleteFriend`
Version	String	是	`2020-12-01`	接口版本，本接口取值：`2020-12-01`

Body

参数名	类型	必填	示例值	描述
AppId	Int	是	`000000`	应用的唯一标志
UserId	Int	是	`10001`	用户 UserId
InboxType	Int	否	`0`	信箱，用做逻辑隔离。默认值为 `0`
DeleteUserIds	Array of Int	是	`[10002，10003]`	要删除的好友 UserId，一次最多删除 10 个好友

请求示例代码

Query

https://rtc.volcengineapi.com?Action=DeleteFriend&Version=2020-12-01

Body

{
    "AppId":000000,
    "UserId":10001,
    "InboxType":0,
    "DeleteUserIds":[10002，10003]
}

返回调用结果

返回参数说明

返回结果参看 BaseResponse。

其中 Result 的结构如下：

参数名	类型	描述
FailedInfos	Array of FailedInfo	删除失败的好友信息

FailedInfo

参数名	类型	描述
UserId	Int	好友 UserId
Code	String	错误码
Message	String	错误描述

正常返回示例

{
    "ResponseMetadata": {
        "RequestId": "Your_RequestId",
        "Action": "DeleteFriend",
        "Version": "2020-12-01",
        "Service": "rtc",
        "Region": "cn-north-1"
    },
    "Result": {
        "FailedInfos": []
    }
}