简体中文

get_stranger_info

get_stranger_info只读好友

获取陌生人信息

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

输入参数

参数	类型	必填	默认	说明
`user_id`	uint	✓		QQ 号

返回 (data)

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

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

字段	类型	必填	说明
`user_id`	integer	✓	QQ 号
`nickname`	string	✓	昵称
`sex`	string	✓	性别（male/female/unknown）
`age`	integer	✓	年龄
`qq_level`	integer	–	QQ 等级（仅查到资料时返回）
`level`	integer	–	QQ 等级，同 qq_level（仅查到资料时返回）

原始 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"
  ]
}

调用示例

curl

Python

JavaScript

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}'

在用 AI 助手？

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

ON THIS PAGE

get_stranger_info#

输入参数#

返回 (data)#

调用示例#

get_stranger_info

输入参数

返回 (data)

调用示例