English

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	✓	昵称
`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	–	企点企业名称；非企点账号或未获取到时为空字符串

Raw 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"
  ]
}

Examples

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

Using an AI assistant?

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

ON THIS PAGE

get_stranger_info#

Parameters#

Returns (data)#

Examples#

get_stranger_info

Parameters

Returns (data)

Examples