简体中文

get_friend_list

get_friend_list只读好友

获取好友列表

通过 POST http://127.0.0.1:3000/get_friend_list（请求体为 JSON 参数）或 WebSocket 调用。

输入参数

该动作无需参数。

返回 (data)

好友列表数组，每项含 QQ 号、昵称与备注。

所有响应都包裹在标准信封中：{ "status": "ok", "retcode": 0, "data": ... }。下表描述 data 字段。

data 为数组，每个元素：

字段	类型	必填	说明
`user_id`	integer	✓	好友 QQ 号
`nickname`	string	✓	好友昵称
`remark`	string	✓	好友备注

原始 JSON Schema

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "user_id": {
        "type": "integer",
        "description": "好友 QQ 号"
      },
      "nickname": {
        "type": "string",
        "description": "好友昵称"
      },
      "remark": {
        "type": "string",
        "description": "好友备注"
      }
    },
    "required": [
      "user_id",
      "nickname",
      "remark"
    ]
  }
}

调用示例

curl

Python

JavaScript

SnowLuma SDK

curl -X POST http://127.0.0.1:3000/get_friend_list \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <access-token>' \
  -d '{}'

在用 AI 助手？

支持 MCP 的客户端可直接发现并调用本动作，无需手写 HTTP。见 MCP 接入。

ON THIS PAGE

get_friend_list#

输入参数#

返回 (data)#

调用示例#

get_friend_list

输入参数

返回 (data)

调用示例