Skip to content

get_unidirectional_friend_list

获取当前账号的单向好友列表。单向好友是仍关注当前账号、但没有出现在普通双向好友列表中的用户。

js
const users = await api.get_unidirectional_friend_list({
  self_id: 106606,
  top: 0,
  count: 99,
})
字段类型必填说明
self_idnumber要查询的在线 Bot QQ 号
topnumber分页起点,默认 0
countnumber本次请求数量,默认 99,最大 200
cookiestringQQ 服务端返回的分页游标;首批不填写

成功时直接返回用户数组:

json
[
  {
    "uin": 1122334455,
    "uid": "u_example",
    "nick_name": "示例用户",
    "age": 0,
    "source": "通过群聊"
  }
]

nick_namesource 由框架解码 QQ Android 9.2.70 的真实响应得到,不使用好友缓存拼接。没有单向好友时返回空数组。

该接口只读取好友关系,不会添加或删除好友。当前仅支持 Android QQ。

调用前必读

协议与使用指南

仅 Android
适用协议
仅 Android
使用前准备
目标 Bot 必须属于当前插件节点并处于在线状态;涉及群或好友操作时,账号还必须具备对应 QQ 权限。
选择协议
const androidApi = api.forProtocol('android') // 省略时也默认 Android

原始 action 请求只使用附件约定的 client_type: 'android' | 'linuxqq';省略时选择 Android。

建议搭配

常见失败原因

  • bot 不属于本节点
  • bot 未在线或账号状态不符合要求
  • client_type 无效或目标协议不支持该 action

注意事项

  • 省略协议选择器时默认 Android;若指定 Linux,框架会明确拒绝,不会转交同 QQ 的 Android 实例。
  • 查询结果可能受 QQ 服务端分页、缓存与权限影响,不应假设一次调用返回全部数据。

萌卡NT 开发文档