批量添加好友

描述

调用此接口，可为用户直接批量添加至多 20 名好友，无需对方同意。如需上调（最多可为 50），请联系 ZEGO 技术支持。

每名用户最多可以拥有 3000 名好友。

为用户添加好友成功后，相关用户的客户端将通过以下 ZIM SDK 的回调接口接收好友列表更新的通知：

接口原型

• 请求方法：POST
• 请求地址：https://zim-api.zego.im/?Action=AddFriends
• 传输协议：HTTPS
• 调用频率限制：20 次/秒。

请求参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表请参考 调用方式 - 公共请求参数。

请求示例

• 请求地址 URL：

  https://zim-api.zego.im/?Action=AddFriends
  &<公共请求参数>

• 请求消息体：

  {
      "FromUserId": "zego_user",
      "FriendInfos": [
          {
              "UserId": "usera1",
              "Wording": "Wording1",
              "FriendAlias": "alias1",
              "Attributes": [
                  {
                      "Key": "k1",
                      "Value": "Value"
                  },
                  {
                      "key": "k2",
                      "Value": "Value1"
                  }
              ]
          },
          {
              "UserId": "usera2",
              "Wording": "Wording2",
              "FriendAlias": "alias2",
              "Attributes": [
                  {
                      "key": "k3",
                      "Value": "Value"
                  },
                  {
                      "key": "k0",
                      "Value": "Value1"
                  }
              ]
          }
      ]
  }

响应参数

响应示例

{
    "Code": 0,
    "Message": "success",
    "RequestId": "343649807833778782",
    "ErrorList": [
        {
            "UserId": "usera2",
            "SubCode": 660800022
        }
    ]
}

返回码

以下仅列出了接口业务逻辑相关的返回码，完整返回码请参考 全局返回码。