English

get_friends_with_category

get_friends_with_category只读扩展

获取分组好友列表

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

Parameters

This action takes no parameters.

Returns (data)

好友分组数组；每组包含 categoryId、categoryName、categoryMbCount 和 buddyList。

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
`categoryId`	integer	✓	分组 ID
`categoryName`	string	✓	分组名称
`categoryMbCount`	integer	✓	服务端报告的分组好友数
`buddyList`	object[]	✓	该分组内的好友

Raw JSON Schema

{
  "type": "array",
  "description": "带分组的好友列表",
  "items": {
    "type": "object",
    "properties": {
      "categoryId": {
        "type": "integer",
        "description": "分组 ID"
      },
      "categoryName": {
        "type": "string",
        "description": "分组名称"
      },
      "categoryMbCount": {
        "type": "integer",
        "description": "服务端报告的分组好友数"
      },
      "buddyList": {
        "type": "array",
        "description": "该分组内的好友",
        "items": {
          "type": "object",
          "properties": {
            "user_id": {
              "type": "integer",
              "description": "QQ 号"
            },
            "nickname": {
              "type": "string",
              "description": "昵称"
            },
            "remark": {
              "type": "string",
              "description": "好友备注"
            }
          },
          "required": [
            "user_id",
            "nickname",
            "remark"
          ]
        }
      }
    },
    "required": [
      "categoryId",
      "categoryName",
      "categoryMbCount",
      "buddyList"
    ]
  }
}

Examples

curl

Python

JavaScript

SnowLuma SDK

curl -X POST http://127.0.0.1:3000/get_friends_with_category \
  -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.

ON THIS PAGE

get_friends_with_category#

Parameters#

Returns (data)#

Examples#

get_friends_with_category

Parameters

Returns (data)

Examples