简体中文

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	✓	昵称
`remark`	string	✓	好友备注；非好友或未设置时为空字符串
`sex`	string	✓	性别（male/female/unknown）
`age`	integer	✓	年龄
`long_nick`	string	✓	个性签名
`qq_level`	integer	–	QQ 等级（仅查到资料时返回）
`level`	integer	–	QQ 等级，同 qq_level（仅查到资料时返回）
`status`	integer	–	在线状态码
`extStatus`	integer	–	扩展状态码
`ext_status`	integer	–	扩展状态码（同 extStatus）
`batteryStatus`	integer	–	电量状态
`customStatus`	object	–	自定义状态
`customStatusDescInfo`	string	–	自定义状态说明
`qidian_master_flag`	integer	–	企点主号标志，0 或 1；普通账号为 0
`qidian_crew_flag`	integer	–	企点员工标志，0 或 1；普通账号为 0
`qidian_crew_flag_2`	integer	–	企点保留标志，0 或 1；普通账号为 0
`qidian_enterprise_name`	string	–	企点企业名称；非企点账号或未获取到时为空字符串

原始 JSON Schema

{
  "type": "object",
  "properties": {
    "user_id": {
      "type": "integer",
      "description": "QQ 号"
    },
    "nickname": {
      "type": "string",
      "description": "昵称"
    },
    "remark": {
      "type": "string",
      "description": "好友备注；非好友或未设置时为空字符串"
    },
    "sex": {
      "type": "string",
      "description": "性别（male/female/unknown）"
    },
    "age": {
      "type": "integer",
      "description": "年龄"
    },
    "long_nick": {
      "type": "string",
      "description": "个性签名"
    },
    "qq_level": {
      "type": "integer",
      "description": "QQ 等级（仅查到资料时返回）"
    },
    "level": {
      "type": "integer",
      "description": "QQ 等级，同 qq_level（仅查到资料时返回）"
    },
    "status": {
      "type": "integer",
      "description": "在线状态码"
    },
    "extStatus": {
      "type": "integer",
      "description": "扩展状态码"
    },
    "ext_status": {
      "type": "integer",
      "description": "扩展状态码（同 extStatus）"
    },
    "batteryStatus": {
      "type": "integer",
      "description": "电量状态"
    },
    "customStatus": {
      "type": "object",
      "description": "自定义状态",
      "nullable": true
    },
    "customStatusDescInfo": {
      "type": "string",
      "description": "自定义状态说明"
    },
    "qidian_master_flag": {
      "type": "integer",
      "description": "企点主号标志，0 或 1；普通账号为 0"
    },
    "qidian_crew_flag": {
      "type": "integer",
      "description": "企点员工标志，0 或 1；普通账号为 0"
    },
    "qidian_crew_flag_2": {
      "type": "integer",
      "description": "企点保留标志，0 或 1；普通账号为 0"
    },
    "qidian_enterprise_name": {
      "type": "string",
      "description": "企点企业名称；非企点账号或未获取到时为空字符串"
    }
  },
  "required": [
    "user_id",
    "nickname",
    "remark",
    "sex",
    "age",
    "long_nick"
  ]
}

调用示例

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)

调用示例