get_friend_list

get_friend_list只读好友
获取好友列表

Call via POST http://127.0.0.1:3000/get_friend_list (JSON params as the body) or WebSocket.

Parameters

This action takes no parameters.

Returns (data)

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

Every response is wrapped in the standard envelope: { "status": "ok", "retcode": 0, "data": ... }. The table below describes data.

data is an array; each element:

Field Type Required Description
user_id integer 好友 QQ 号
nickname string 好友昵称
remark string 好友备注
Raw 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"
    ]
  }
}

Examples

curl
Python
JavaScript
Go
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 '{}'
Using an AI assistant?

MCP-capable clients can discover and call this action directly — no hand-written HTTP. See MCP.