set_friend_request

通过请求键处理当前账号的好友申请。

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

request_key 必须来自当前账号最新的 get_friend_requests 结果。approve=true 同意，false 拒绝。Linux 可疑申请不支持设置 remark：同意时返回 action=approve_filtered_request，拒绝时返回 action=remove_filtered_request，后者清除过滤申请，不保证向申请人发送拒绝通知。

适用协议

Android / Linux QQ。

调用方式

向已认证的 WebSocket 连接发送：

{
  "type": "action",
  "id": "example-1",
  "action": "set_friend_request",
  "params": {
    "self_id": 123456789,
    "protocol_id": 0,
    "request_key": "example",
    "approve": true
  }
}

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

参数

参数	类型	必填	说明
self_id	integer	是	当前框架内的账号 QQ 号
protocol_id	integer	是	账号协议配置 ID；从 get_protocol_list 获取，必须显式传入，0 也是有效 ID
request_key	string	是	申请列表返回的请求键
approve	boolean	是	true 同意，false 拒绝
remark	string	否	备注；允许清除时传空字符串

返回值

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

字段	类型	说明
success	boolean	操作是否成功
action	string	实际执行的申请处理方式