_get_friend_dress

_get_friend_dress只读扩展
获取指定 QQ 号正在使用的个性装扮(挂件/名片/来电/输入状态等)

通过 POST http://127.0.0.1:3000/_get_friend_dress(请求体为 JSON 参数)或 WebSocket 调用。

输入参数

参数 类型 必填 默认 说明
user_id uint 目标 QQ 号

返回 (data)

装扮信息;目标未使用任何可查询装扮时 items 为空数组。网络失败、未登录态/风控、页面改版、返回账号与请求不一致时返回失败并附具体原因

该动作返回标准 OneBot 信封;data 结构待补充。

调用示例

curl
Python
JavaScript
Go
SnowLuma SDK
curl -X POST http://127.0.0.1:3000/_get_friend_dress \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <access-token>' \
  -d '{"user_id":10001}'
在用 AI 助手?

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