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_id | integer | 是 | 当前框架内的账号 QQ 号 |
protocol_id | integer | 是 | 账号协议配置 ID;从 get_protocol_list 获取,必须显式传入,0 也是有效 ID |
doubt_only | boolean | 否 | 只读取可疑申请,默认 false |
count | integer | 否 | 最多返回条数,默认 50,范围 1–100 |
返回值
以下为成功响应的 data,错误通过 ok: false 与 error 返回。
data 为数组,下表描述每个元素。
| 字段 | 类型 | 说明 |
|---|---|---|
request_key | string | 申请列表返回的请求键 |
user_id | integer | 目标 QQ 号 |
user_uid | string | QQ 原生用户 UID |
nickname | string | 昵称 |
comment | string | 申请附言 |
source | string | 申请来源 |
time | integer | 业务时间戳 |
status | integer | 处理状态 |
doubt | boolean | 是否为可疑申请 |
