Skip to content

get_friend_requests ​

获取当前账号的好友申请。

此接口在已认证的服务连接中调用,账号须属于当前框架且处于在线状态。self_id 与 protocol_id 共同选择账号。

doubt_only 默认 false,设为 true 只返回可疑好友申请。count 默认 50,范围 1–100。返回数组最多包含 count 条;没有持久分页游标。请使用结果中的 request_key 处理申请。

适用协议

Android / Linux QQ。

调用方式 ​

向已认证的 WebSocket 连接发送:

json
{
  "type": "action",
  "id": "example-1",
  "action": "get_friend_requests",
  "params": {
    "self_id": 123456789,
    "protocol_id": 0
  }
}

响应通过相同 id 对应请求。连接、HTTP 调用与错误处理见通信协议。

参数 ​

参数类型必填说明
self_idinteger是当前框架内的账号 QQ 号
protocol_idinteger是账号协议配置 ID;从 get_protocol_list 获取,必须显式传入,0 也是有效 ID
doubt_onlyboolean否只读取可疑申请,默认 false
countinteger否最多返回条数,默认 50,范围 1–100

返回值 ​

以下为成功响应的 data,错误通过 ok: false 与 error 返回。

data 为数组,下表描述每个元素。

字段类型说明
request_keystring申请列表返回的请求键
user_idinteger目标 QQ 号
user_uidstringQQ 原生用户 UID
nicknamestring昵称
commentstring申请附言
sourcestring申请来源
timeinteger业务时间戳
statusinteger处理状态
doubtboolean是否为可疑申请

萌卡 · 自托管 QQ 机器人框架