logo
即时通讯
机器人
ZIM Audio
当前页

检查好友关系

POST

https://zim-api.zego.im/

调用此接口,可为一名用户批量检查其与至多 20 名其他用户的好友关系。如需上调(最多可为 50),请联系 ZEGO 技术支持。

ZEGO 支持单边或双边检查好友关系,以检查用户 A 与目标用户 B 的好友关系为例:

  • 单边检查:仅检查用户 A 的好友列表是否有用户 B。
  • 双边检查:同时检查用户 A 和用户 B 的好友列表是否有对方。

检查好友关系的结果可能有:

检查类型Relation说明
A 的好友列表有 BB 的好友列表有 A
单向1无法确认
2✔️无法确认
双向3
4✔️
5✔️
6✔️✔️
说明

参数 FromUserIdUserId 对应的用户已在客户端调用 login 方法登录 ZIM 服务,或已调用 服务端 API 完成注册。

说明
调用频率限制:20 次/秒。

Request

Query Parameters

    Action string必填

    可选值: [CheckFriendsRelation]

    接口原型参数

    https://zim-api.zego.im/?Action=CheckFriendsRelation

    AppId uint32必填

    💡公共参数。应用 Id,由 ZEGO 分配的用户唯一凭证。可从 ZEGO 控制台 获取。

    SignatureNonce string必填

    💡公共参数。16 位 16 进制随机字符串(8 字节随机数的 hex 编码)。生成算法可参考 签名示例

    Timestamp int64必填

    💡公共参数。当前 Unix 时间戳,单位为秒。生成算法可参考 签名示例,最多允许 10 分钟的误差。

    SignatureVersion string必填

    可选值: [2.0]

    默认值: 2.0

    💡公共参数。签名版本号。

    Signature string必填

    💡公共参数。签名,用于验证请求的合法性。请参考签名机制生成。

Body

required
    FromUserId string必填

    可选值: <= 32 characters

    为此 UserId 查询好友关系。

    UserIds string[]必填

    可选值: <= 20

    待检查好友关系的目标用户列表。默认数量上限为 20。

    CheckType number必填

    可选值: [0, 1]

    检查类型:

    • 0:双向检查。
    • 1:单向检查。

Responses

OK
Schema
    Code number

    返回码。

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

    说明

    当您发起请求同时检查 FromUserId 与多名用户的好友关系时:

    • 如果成功检查 FromUserId 与 1 名或更多用户的好友关系,Code 都会返回 0。此时请参考 Fails 中的具体信息,确认操作结果。
    • 如果 FromUserId 与全部目标用户的好友关系都检查失败,Code 会返回相关返回码,具体请参考 全局返回码
    Code / SubCode描述处理建议
    660000001业务类通用错误。请重试,或联系 ZEGO 技术支持。
    660000002输入参数错误。请检查输入的参数。
    660300005调用接口的频率超出了 AppID 级别限制。请稍后再试。
    Message string

    请求结果的说明信息。

    RequestId string

    请求 ID。

    Successes object[]
    检查成功列表。
  • Array[
  • UserId string

    成功检查 FromUserId 与此用户 ID 的好友关系。

    Relation number

    关系类型,详情请参考本接口功能描述。

  • ]
  • Fails object[]
    检查失败列表。
    • Code 为 0:
    • Fails 为空,表示成功检查 FromUserId 与全部目标用户的好友关系。
    • Fails 不为空,表示 FromUserId 与部分目标用户的好友关系检查失败,请参考 SubCode 处理。
    • Code 不为 0:
    • Fails 为空,表示参数错误、接口频率限制、系统错误。
    • Fails 不为空,表示FromUserId 与全部目标用户的好友关系检查失败。
  • Array[
  • UserId string

    FromUserId 与此用户 ID 的好友关系检查失败。

    SubCode number

    具体失败返回码,完整返回码请参考 Code 说明或者 全局返回码

    Relation number

    关系类型。仅当请求参数 CheckType 为 0 时,此字段有值,为 1 或 2,相关数值详情请参考本接口功能描述。

  • ]

Previous

查询好友列表

Next

更新好友备注

当前页

返回到顶部