get_stranger_info

get_stranger_info只读好友
获取陌生人信息

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

Parameters

Param Type Required Default Description
user_id uint QQ 号

Returns (data)

陌生人资料:QQ 号、昵称、性别、年龄,命中资料时另含等级。

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

Field Type Required Description
user_id integer QQ 号
nickname string 昵称
sex string 性别(male/female/unknown)
age integer 年龄
qq_level integer QQ 等级(仅查到资料时返回)
level integer QQ 等级,同 qq_level(仅查到资料时返回)
Raw JSON Schema
{
  "type": "object",
  "properties": {
    "user_id": {
      "type": "integer",
      "description": "QQ 号"
    },
    "nickname": {
      "type": "string",
      "description": "昵称"
    },
    "sex": {
      "type": "string",
      "description": "性别(male/female/unknown)"
    },
    "age": {
      "type": "integer",
      "description": "年龄"
    },
    "qq_level": {
      "type": "integer",
      "description": "QQ 等级(仅查到资料时返回)"
    },
    "level": {
      "type": "integer",
      "description": "QQ 等级,同 qq_level(仅查到资料时返回)"
    }
  },
  "required": [
    "user_id",
    "nickname",
    "sex",
    "age"
  ]
}

Examples

curl
Python
JavaScript
Go
SnowLuma SDK
curl -X POST http://127.0.0.1:3000/get_stranger_info \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <access-token>' \
  -d '{"user_id":10001}'
Using an AI assistant?

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